docs / otto

Otto.de API

base /otto/v15 endpoints

post/otto/v1/search1 credit

Keyword search with brand/sort/price/rating/availability filters and offset pagination.

Parameter		Allowed / range	Description
query	required	—	Search keyword.
brand	optional	—	Filter by brand slug (lowercased), e.g. apple, samsung.
sort	optional	—	Otto sort key (German 'sortierung', e.g. preis-aufsteigend, bewertung, neuheiten).
price_min	optional	—	Minimum price (EUR).
price_max	optional	—	Maximum price (EUR).
preis	optional	—	Advanced: raw Otto price range 'lo-hi' (overrides price_min/price_max).
min_rating	optional	1–5	Minimum star rating filter (1-5).
condition	optional	—	Otto Zustand filter (German value, e.g. neu, gebraucht).
availability	optional	—	Otto Verfuegbarkeit filter (German value).
offset = 0	optional	0–	Pagination offset (skip N, page size 72). Page with meta.next_offset.

Try in playground →

post/otto/v1/product1 credit

Product facts by variation_id.

Parameter		Allowed / range	Description
id	required	—	Otto variation id.
query	required	—	Keyword the variation appears under — Otto's standalone PDP is 429-walled, so detail is read from the search grid.

Try in playground →

post/otto/v1/browse1 credit

Category browse (e.g. moebel, technik/computer) with filters and offset pagination.

Parameter		Allowed / range	Description
category	required	—	Otto category path, e.g. moebel or technik/computer (discover via the categories action).
brand	optional	—	Filter by brand slug (lowercased), e.g. apple, samsung.
sort	optional	—	Otto sort key (German 'sortierung', e.g. preis-aufsteigend, bewertung, neuheiten).
price_min	optional	—	Minimum price (EUR).
price_max	optional	—	Maximum price (EUR).
preis	optional	—	Advanced: raw Otto price range 'lo-hi' (overrides price_min/price_max).
min_rating	optional	1–5	Minimum star rating filter (1-5).
condition	optional	—	Otto Zustand filter (German value, e.g. neu, gebraucht).
availability	optional	—	Otto Verfuegbarkeit filter (German value).
offset = 0	optional	0–	Pagination offset (skip N, page size 72). Page with meta.next_offset.

Try in playground →

post/otto/v1/brands1 credit

Brand filter links available on a category landing page.

Parameter		Allowed / range	Description
category	required	—	Otto category path to list brand filters for.

Try in playground →

post/otto/v1/categories1 credit

Top-level department tree from homepage, or child categories for a parent path.

Parameter		Allowed / range	Description
parent	optional	—	Parent category path to list children of (omit for top-level departments).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/otto/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}