APIs / OTTO / Search

OTTO: Search

Search from OTTO as JSON. 1 credit per successful call.

GET /v1/otto/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
querystringRequiredUp to 150 characters
brandstringOptionalUp to 80 characters
colorstringOptionalschwarz, weiss, grau, blau, rot, gruen, gelb, braun, beige, rosa, lila, orange, bunt
min_priceintegerOptionalAny
max_priceintegerOptionalAny
on_salebooleanOptionalAny
sortstringOptionalrelevance, rating, price_low_to_high, price_high_to_low
pageintegerOptionalAny

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.