Setup guide

How to connect your Otto products to MarktRank

Three ways to get your products in, from a two-minute manual start to a full catalogue sync via the OTTO API. You can read this before you buy; nothing here needs an account to understand.

Deutsche Version

What MarktRank does

Track where your products rank on otto.de

MarktRank searches otto.de for the keywords you choose, finds your product on every results page and records its organic position, its sponsored (ad) position and the page it appears on. Checks run on our servers in Germany, nothing to install, and your computer can be off.

1Quick start (3 minutes)

  1. Create an account and choose a plan. Pro covers one brand; Agency covers up to 5 client projects.
  2. Add your products, using one of the two ways above. Imported products arrive switched off, so nothing is checked until you decide.
  3. Open a product and add the keywords buyers type into the otto.de search box (one per line). Pick how many result pages to search.
  4. Within a few minutes the first positions appear. From then on every keyword is checked automatically every week, and you can refresh any time.

Tip Start with 3–5 important products and 5–10 keywords each. Add more once you see which keywords bring your products to page 1.

2Add products manually

Use the Add products box on the dashboard. No API access and no technical setup needed.

  1. One product: paste the otto.de product link (or just the product ID, the code at the end of the link, e.g. S0ABC1D2) and click Add product. A name is optional; the real title and image are read from otto.de.
  2. Many products with keywords at once: open Add products and their keywords in bulk and paste one product per line:
    otto.de link or product ID | name | keyword 1, keyword 2, …
    S0ABC1D2 | Kids mattress 70x140 | kindermatratze 70x140, matratze kinderbett
    S0XYZ9K8
    Name and keywords are optional. Keywords on each line are checked immediately.
  3. Choose the search depth next to Add all (see section 4) and click Add all.
  4. Whole catalogue from an OTTO report: open Upload an OTTO report and choose a file from OTTO Partner Connect. Two files work:
    • Product export (Excel): in Partner Connect go to Products → Product overview → Download marketplace status. It contains product reference, SKU, EAN, the otto.de link and the marketplace status of every product, but no sales figures.
    • Controlling report (CSV with Product Title, Product Reference, SKU, EAN, Revenue, Trend): export the product table in the Controlling area of Partner Connect for the period you want. It adds the revenue per product, and the product list is then sorted by best sellers.
    You see a preview first. New products arrive with tracking switched off, so switch on the ones you want to track; existing products get their reference, title and revenue. Upload the controlling report again whenever you want fresh sales figures.

Tip A product that is already in the project is not added twice; the bulk box simply adds the new keywords to it. You can paste a keyword list for your whole catalogue this way.

EANs are accepted too, but otto.de's own search does not index EANs, so an EAN-only product is matched only when its otto.de page can be proven to carry that EAN. A link or product ID always works.

3Connect the OTTO API (OTTO Partner Connect)

For sellers on OTTO Market. MarktRank only reads your product list; it never changes anything in your OTTO account.

  1. Log in to OTTO Partner Connect (portal.otto.market) → Settings → API access → create a self-app with the products scope.
  2. Copy the client ID and the client secret. OTTO shows the secret only once, so copy it immediately.
  3. In MarktRank click Connect OTTO API (in the Add products box), choose Production (Live), paste both values and save. The connection is tested on the spot.
  4. Click Import / sync products now. Your catalogue arrives with SKUs, EANs and, where OTTO provides it, the otto.de link. Switch on tracking for the products you want to follow.

Tip Credentials made on the Sandbox tab of Partner Connect only work with "Sandbox" selected. Secrets are stored encrypted, are only used to read your catalogue and are never shown again, not even to your team.

Agencies: connect each client's OTTO account inside that client's own project (see section 7).

4Keywords & search depth

  • Add keywords on a product's page, one per line, exactly as buyers search (e.g. kindermatratze 70x140). Upper and lower case do not matter.
  • Search depth decides how many results pages are checked: from Page 1 only up to All pages (up to 60). otto.de shows 120 products per page, so page 1 already covers the top 120 and Top 5 pages covers 600. Deeper searches take longer.
  • Discover keywords (top of every product page): MarktRank reads the product on otto.de, asks Otto's search box what buyers type and keeps only terms that match the product. Find & track top 5 tracks the 5 best automatically (exact ones first, then those where the product already ranks); Find keywords only shows the list for you to pick from. Exact = built from the product's own words, close = also from its description or category. On the dashboard, Find & track top 5 for products without keywords does this for your whole catalogue in one click.
  • Remove a keyword at any time; its history is deleted with it.

5Reading your results

Organic position

Your product's place among the normal (non-paid) results, counted across all pages. #27 means 27th unpaid result.

Ad position

Where your product appears as a sponsored result, if you advertise on that keyword.

Overall position & page

The place including ads, and the results page it is on (otto.de currently shows 120 products per page, so page 2 starts at position 121).

Not found

The product was not within the pages searched. Increase the search depth or check that the product is online on otto.de.

  • The dashboard shows how many keywords are on page 1, page 2, page 3+ or not found, plus the biggest movers.
  • Compare with (top of the dashboard and of every product) sets how far back the change columns look: yesterday, 2, 3, 7, 14, 30, 60 or 90 days. You see how many keywords improved or declined, page-1 counts then and now, and the biggest movers for that period.
  • Click a keyword's trend line to open its full history: a chart and a day-by-day table for 7 days up to 1 year. Every check is stored, nothing is overwritten.
  • Report: pick any date range and get a printable report (download as PDF or CSV) with every keyword's position on the first and last day, what improved or declined, page-1 counts and the trend. Clients with view-only access can download it too.
  • Checks are made from a German connection, like a shopper in Germany. otto.de still rotates ads and tests layouts, so a position can move a few places between two checks. Watch the trend, not a single check.

6Checks, schedule & export

  • Automatic: every tracked keyword is re-checked weekly. Switch the project to daily checks (next to "Compare with") for day-by-day history; weekly is enough for trends.
  • Refresh ranks on a product checks all its keywords now; the status at the top shows when checks are running.
  • Track on/off: switch tracking off for products you don't need; their history is kept. Switch all tracking off pauses a whole project.
  • Tracking paused: if otto.de briefly limits requests, checks pause and resume automatically. Nothing is lost and no wrong position is recorded.
  • Export CSV (top right) downloads all current positions of the project; opens in Excel or Google Sheets.

7Agencies & clients

  • Projects: on the Agency plan, create one project per client or brand (+ New project). Each project has its own products, keywords, history and OTTO connection. Switch projects with the selector at the top.
  • Roles: the Owner pays and can do everything. Managers can create projects, connect OTTO accounts, invite people and assign projects. Members (your staff) see and work only on the projects assigned to them. Clients get view-only access to their own project.
  • Give a client access: in Projects & team, enter the client's email, choose Client – view only, tick their project and click Invite. They see their rankings, history and CSV export, and nothing else: no other clients, no team, no billing, and they cannot change anything.
  • Client OTTO credentials are use-only: nobody on the team can read a secret back out. Removing a person only deletes their login; the project data stays.

8Plans & limits

ProAgencyEnterprise
Brands / client projects156+
Products1,0005,000Sized to you
Keywords under weekly tracking5,00025,000Sized to you
Team members & roles–✓✓

Prices and a full comparison are on the pricing section. For more capacity, talk to us about Enterprise.

9Troubleshooting

My product shows "Not found"

Increase the search depth for that keyword, check the product is online on otto.de, and make sure the Otto ID is correct (open the product; the otto.de link should open your product).

The position differs from what I see in my browser

otto.de personalises results by country and visitor, and ads rotate. MarktRank checks from a German connection without login or history, like a new shopper in Germany. If you check from outside Germany, or while logged in, you will see a different order. Compare trends over several checks.

"Tracking paused" at the top

otto.de limited requests for a moment. Checks resume automatically within minutes; nothing needs to be done.

The OTTO API connection fails

Check that the app has the products scope and that "Production (Live)" vs "Sandbox" matches where you created the credentials. A new secret can be generated in Partner Connect if the old one was lost.

Do I need the OTTO API to use MarktRank?

No. Manual entry works for every seller and brand, with no API access at all. The API is simply the fastest way to bring in a large catalogue with SKUs and EANs.

Ready to start? Your first ranks appear within minutes.

Start tracking

Still have a question? Contact us, we reply within one business day.

↑ Back to top