docs / kleinanzeigen

Kleinanzeigen API

base /kleinanzeigen/v15 endpoints

post/kleinanzeigen/v1/search1 credit

Keyword search with optional location, category, sort, price range, seller type, pagination.

Parameter		Allowed / range	Description
query	optional	—	Free-text keyword. (search needs query OR category_slug.)
location	optional	—	City / postal code to scope results (e.g. Berlin or 10115).
category_id	optional	—	Numeric category id (the c<NNN> in a category URL).
category_slug	optional	—	Category slug, e.g. handy-telefon (from a category URL s-<slug>).
sort	optional	—	Sort key passed to Kleinanzeigen's sortierung (e.g. preis, neueste).
price_min	optional	—	Minimum price in EUR (whole euros, not cents).
price_max	optional	—	Maximum price in EUR.
seller_type	optional	privat · gewerblich	Seller type filter. privat=private, gewerblich=commercial dealer.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/kleinanzeigen/v1/location_suggestions1 credit

Autocomplete location names/ids for a partial query (JSON endpoint).

Parameter		Allowed / range	Description
query	required	—	Partial location text to autocomplete (e.g. Munc).

Try in playground →

post/kleinanzeigen/v1/listing1 credit

Full listing detail by url or slug path.

Parameter		Allowed / range	Description
url	optional	—	Full Kleinanzeigen listing URL. (listing needs url OR slug.)
slug	optional	—	Listing slug/path (the s-anzeige/... part, alternative to url).

Try in playground →

post/kleinanzeigen/v1/categories1 credit

Browse subcategories and listings for a category page.

Parameter		Allowed / range	Description
category_id	optional	—	Category id to browse (omit for the top-level category index).
category_slug	optional	—	Category slug to browse (pairs with category_id).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/kleinanzeigen/v1/user_listings1 credit

All active listings for a seller poster_id/user_id.

Parameter		Allowed / range	Description
user_id	required	—	Seller user/poster id (a listing's poster_id).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/kleinanzeigen/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
}