Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / OTTO

1 credit per call4 endpoints20 datapoints

OTTO API

OTTO API for product search with brand, colour, price and sale filters, suggestions, product details and reviews as JSON, from 1 credit per call.

Get a free API keyRun it below
OTTO
GET/v1/otto/search?query=winterjacke+damen
{
  "success": true,
  "query": "winterjacke damen",
  "items": [
    {
      "position": 1,
      "id": "S0UKQ0SD",
      "variation_id": "S2QDHKM5QF9W",
      "article_number": "S0UKQ0SDC5J",
      "title": "ATLASLAVA Wintermantel Damen Lang Fleece Winterjacke Warme Mantel (1-tlg) Winter Parka mit Kapuze & Kordelzug, 2-Wege-Reißverschluss",
      "brand": "ATLASLAVA",
      "category": "Mäntel",
      "url": "https://www.otto.de/p/atlaslava-wintermantel-damen-lang-fleece-winterjacke-warme-mantel-1-tlg-winter-parka-mit-kapuze-kordelzug-2-wege-reissverschluss-S0UKQ0SD/?variationId=S2QDHKM5QF9W",
      "price": 87.99,
      "original_price": 125.99,
      "discount_percent": 30,
      "currency": "EUR",
      "price_from": false,
      "on_sale": true,
      "rating": 4,
      "review_count": 1,
      "availability": {
        "state": "AVAILABLE",
        "text": "lieferbar - in 3-4 Werktagen bei dir"
      },
      "multiple_sizes": true,
      "colors": [
        {
          "name": "Hellgrau",
          "base_color": "grau",
          "hex": "#716F6E",
          "variation_id": "S3PWFSEDSDSG",
          "selected": false
        },
        {
          "name": "Schwarz",
          "base_color": "schwarz",
          "hex": "#151515",
          "variation_id": "SLF9C2GWKQMW",
          "selected": false
        },
        {
          "name": "Dunkelgrau",
          "base_color": "grau",
          "hex": "#4E4D51",
          "variation_id": "SHUI8ACDCGCJ",
          "selected": false
        }
      ],
      "images": [
        "https://i.otto.de/i/otto/bc9c4c63-b7e2-4f7c-bcc8-58211a26bc4d?$formatz$",
        "https://i.otto.de/i/otto/0165512d-e5ef-4a05-8f02-6debc50092a7?$formatz$",
        "https://i.otto.de/i/otto/f3d3e145-5b59-435c-88d9-22573ddfc23f?$formatz$"
      ]
    },
    {
      "position": 2,
      "id": "C1561210273",
      "variation_id": "1561210275",
      "article_number": "67650609",
      "title": "Navahoo Steppjacke Milianaa Edle Winterjacke mit weicher Kunstfell-Kapuze",
      "brand": "Navahoo",
      "category": "Jacken",
      "url": "https://www.otto.de/p/navahoo-winterjacke-milianaa-edle-winterjacke-mit-weicher-kunstfell-kapuze-C1561210273/?variationId=1561210275",
      "price": 149.95,
      "currency": "EUR",
      "price_from": false,
      "on_sale": false,
      "rating": 4.5,
      "review_count": 209,
      "availability": {
        "state": "AVAILABLE",
        "text": "lieferbar - in 3-4 Werktagen bei dir"
      },
      "multiple_sizes": true,
      "colors": [
        {
          "name": "Smaragd Green",
          "base_color": "grün",
          "hex": "#2A7140",
          "variation_id": "1905992475",
          "selected": false
        },
        {
          "name": "Yellow",
          "base_color": "gelb",
          "hex": "#E08F00",
          "variation_id": "1561723368",
          "selected": false
        },
        {
          "name": "olivgrün",
          "base_color": "grün",
          "hex": "#343425",
          "variation_id": "1683833470",
          "selected": false
        }
      ],
      "images": [
        "https://i.otto.de/i/otto/247d0fb1-ff03-5543-b85f-820a2f98dc64?$formatz$",
        "https://i.otto.de/i/otto/4ea3a5a3-d444-53b9-98b9-bbf57844eb94?$formatz$",
        "https://i.otto.de/i/otto/219d7e6d-9755-58ea-89cf-4c2928c0f6e1?$formatz$"
      ]
    },
    {
      "position": 3,
      "id": "1920709611",
      "variation_id": "1920709703",
      "article_number": "41820668",
      "title": "Marikoo Winterjacke Kaituu XVI mit großer Kapuze",
      "brand": "Marikoo",
      "category": "Jacken",
      "url": "https://www.otto.de/p/marikoo-winterjacke-kaituu-xvi-mit-grosser-kapuze-1920709611/?variationId=1920709703",
      "price": 94.95,
      "original_price": 119.95,
      "discount_percent": 21,
      "currency": "EUR",
      "price_from": false,
      "on_sale": true,
      "rating": 4,
      "review_count": 39,
      "availability": {
        "state": "AVAILABLE",
        "text": "lieferbar - in 3-4 Werktagen bei dir"
      },
      "multiple_sizes": true,
      "colors": [
        {
          "name": "Dark Red",
          "base_color": "rot",
          "hex": "#800F21",
          "variation_id": "1920709662",
          "selected": false
        },
        {
          "name": "Light Taupe",
          "base_color": "braun",
          "hex": "#87705D",
          "variation_id": "2026060715",
          "selected": false
        },
        {
          "name": "Schwarz",
          "base_color": "schwarz",
          "hex": "#1F1F1F",
          "variation_id": "1920709745",
          "selected": false
        }
      ],
      "images": [
        "https://i.otto.de/i/otto/fd44980d-1842-5849-badd-53d68c1e2b59?$formatz$",
        "https://i.otto.de/i/otto/bca89e4c-2ace-5048-b301-198f1e1c387b?$formatz$",
        "https://i.otto.de/i/otto/b978a3c9-e7c9-541a-9736-2a40418158d1?$formatz$"
      ]
    }
  ],
  "total": 2815,
  "page": 1,
  "page_size": 120,
  "has_more": true,
  "sort": "relevance",
  "filtered_out": 0,
  "meta": {
    "endpoint_family": "otto-search",
    "attempts": 3,
    "request_id": "req_473100bcb4c447bc99dde7ec0fc064a5",
    "credits_charged": 1,
    "credits_remaining": 1928
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#positionintegeridstringvariation_idstringarticle_numberstringtitlestringbrandstringcategorystringurlurlpricenumberoriginal_pricenumberdiscount_percentnumbercurrencystringprice_frombooleanon_salebooleanratingnumberreview_countintegeravailabilityobjectmultiple_sizesbooleancolorsobject[]imagesstring[]
11S0UKQ0SDS2QDHKM5QF9WS0UKQ0SDC5JATLASLAVA Wintermantel Damen Lang Fleece Winterjacke Warme Mantel (1-tlg) Winter Parka mit Kapuze & Kordelzug, 2-Wege-ReißverschlussATLASLAVAMäntelhttps://www.otto.de/p/atlaslava-wintermantel-damen-lang-fleece-winterjacke-warme-mantel-1-tlg-winter-parka-mit-kapuze-kordelzug-2-wege-reissverschluss-S0UKQ0SD/?variationId=S2QDHKM5QF9W87.99125.9930EURfalsetrue41{2 fields}true[3 items][3 items]
22C1561210273156121027567650609Navahoo Steppjacke Milianaa Edle Winterjacke mit weicher Kunstfell-KapuzeNavahooJackenhttps://www.otto.de/p/navahoo-winterjacke-milianaa-edle-winterjacke-mit-weicher-kunstfell-kapuze-C1561210273/?variationId=1561210275149.95——EURfalsefalse4.5209{2 fields}true[3 items][3 items]
331920709611192070970341820668Marikoo Winterjacke Kaituu XVI mit großer KapuzeMarikooJackenhttps://www.otto.de/p/marikoo-winterjacke-kaituu-xvi-mit-grosser-kapuze-1920709611/?variationId=192070970394.95119.9521EURfalsetrue439{2 fields}true[3 items][3 items]

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/otto/search?query=winterjacke+damen

20 datapoints

Identity

  • idstring
  • variation_idstring
  • titlestring
  • brandstring
  • categorystring

Contact

  • urlurl

Reputation

  • ratingnumber
  • review_countinteger
  • imagesstring[]

Price

  • pricenumber
  • original_pricenumber
  • discount_percentnumber
  • currencystring
  • price_fromboolean

Other

  • positioninteger
  • article_numberstring
  • on_saleboolean
  • availabilityobject
  • multiple_sizesboolean
  • colorsobject[]

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/otto/search?query=winterjacke+damen" \
  -H "X-API-Key: $API_KEY"

OTTO · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/otto/product
none+3 optional
2 credits
GET/v1/otto/reviews
none+3 optional
1 credit
GET/v1/otto/search
query+7 optional
1 credit
GET/v1/otto/suggest
query+1 optional
1 credit

Overview

What you can get

The OTTO API returns OTTO marketplace data as JSON through 4 endpoints.

  • Search: search takes a query, with brand, color (schwarz, weiss, grau, blau, rot, gruen, gelb, braun, beige, rosa, lila, orange or bunt), min_price, max_price, on_sale, sort (relevance, rating, price_low_to_high or price_high_to_low) and page. suggest takes a partial query, with limit.
  • Products: product takes an id or a product url, with variation_id.
  • Reviews: reviews takes an id or a product url, with page.

The recorded search for "winterjacke damen" returns items, each with position, id, variation_id, article_number, title, brand, category, url, price, original_price, discount_percent, currency, on_sale, rating, review_count, availability, colors and images. It also returns total (2815 in that recording), page, page_size and has_more.

How a call works

Search, then look up: GET /v1/otto/search?query=winterjacke damen&on_sale=true with your key in the X-API-Key header. Each result carries a url; product and reviews take that url. Check has_more before asking for the next page. search, suggest and reviews cost 1 credit per successful call and product costs 2; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track prices and discounts for products on OTTO

Use the OTTO API to track prices and discounts for products on OTTO

Watch which products in a query are on sale with `on_sale`

Use the OTTO API to watch which products in a query are on sale with `on_sale`

Check availability for a product list

Use the OTTO API to check availability for a product list

Read product reviews page by page

Use the OTTO API to read product reviews page by page

FAQ

Questions

How much does the OTTO API cost?

`search`, `suggest` and `reviews` cost one credit per successful call, and `product` costs two. New accounts get free credits to start, and credit packs bring the price down as you scale.

Do I need an OTTO account?

No. You call this OTTO API with your Perceptlayer key in the `X-API-Key` header, with no OTTO login.

Can I filter by colour?

Yes. `search` takes a `color` from a fixed list of German colour names, such as schwarz, blau or beige.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build an OTTO scraper instead?

You can, but an OTTO scraper is code you maintain: page changes break it, requests get blocked, and OTTO's terms govern how you collect data. The OTTO API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the OTTO API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs