OTTO: Search
Search from OTTO as JSON. 1 credit per successful call.
GET /v1/otto/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
query | string | Required | Up to 150 characters |
brand | string | Optional | Up to 80 characters |
color | string | Optional | schwarz, weiss, grau, blau, rot, gruen, gelb, braun, beige, rosa, lila, orange, bunt |
min_price | integer | Optional | Any |
max_price | integer | Optional | Any |
on_sale | boolean | Optional | Any |
sort | string | Optional | relevance, rating, price_low_to_high, price_high_to_low |
page | integer | Optional | Any |
Example request
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.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.