--- title: "OTTO API: JSON data, 4 endpoints, 1 credit per call" description: "OTTO API for product search with brand, colour, price and sale filters, suggestions, product details and reviews as JSON, from 1 credit per call." url: https://perceptlayer.com/apis/otto --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / OTTO 1 credit per call 4 endpoints 20 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | position integer | id string | variation\_id string | article\_number string | title string | brand string | category string | url url | price number | original\_price number | discount\_percent number | currency string | price\_from boolean | on\_sale boolean | rating number | review\_count integer | availability object | multiple\_sizes boolean | colors object\[\] | images string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 1 | S0UKQ0SD | S2QDHKM5QF9W | S0UKQ0SDC5J | ATLASLAVA Wintermantel Damen Lang Fleece Winterjacke Warme Mantel (1-tlg) Winter Parka mit Kapuze & Kordelzug, 2-Wege-Reißverschluss | ATLASLAVA | Mäntel | 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 | 87.99 | 125.99 | 30 | EUR | false | true | 4 | 1 | {2 fields} | true | \[3 items\] | \[3 items\] | | 2 | 2 | C1561210273 | 1561210275 | 67650609 | Navahoo Steppjacke Milianaa Edle Winterjacke mit weicher Kunstfell-Kapuze | Navahoo | Jacken | https://www.otto.de/p/navahoo-winterjacke-milianaa-edle-winterjacke-mit-weicher-kunstfell-kapuze-C1561210273/?variationId=1561210275 | 149.95 | — | — | EUR | false | false | 4.5 | 209 | {2 fields} | true | \[3 items\] | \[3 items\] | | 3 | 3 | 1920709611 | 1920709703 | 41820668 | Marikoo Winterjacke Kaituu XVI mit großer Kapuze | Marikoo | Jacken | https://www.otto.de/p/marikoo-winterjacke-kaituu-xvi-mit-grosser-kapuze-1920709611/?variationId=1920709703 | 94.95 | 119.95 | 21 | EUR | false | true | 4 | 39 | {2 fields} | true | \[3 items\] | \[3 items\] | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/otto/search?query=winterjacke+damen 20 datapoints ### Identity - id string - variation\_id string - title string - brand string - category string ### Contact - url url ### Reputation - rating number - review\_count integer - images string\[\] ### Price - price number - original\_price number - discount\_percent number - currency string - price\_from boolean ### Other - position integer - article\_number string - on\_sale boolean - availability object - multiple\_sizes boolean - colors object\[\] Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/otto/product`](https://perceptlayer.com/apis/otto/product) | none +3 optional | 2 credits | | [GET `/v1/otto/reviews`](https://perceptlayer.com/apis/otto/reviews) | none +3 optional | 1 credit | | [GET `/v1/otto/search`](https://perceptlayer.com/apis/otto/search) | `query` +7 optional | 1 credit | | [GET `/v1/otto/suggest`](https://perceptlayer.com/apis/otto/suggest) | `query` +1 optional | 1 credit | Overview ## About the OTTO API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)