---
title: "OTTO API: Search | Perceptlayer"
description: "Search from OTTO as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/otto/search
---

[APIs](https://perceptlayer.com/apis) / [OTTO](https://perceptlayer.com/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.

| 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/otto?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.