Kleinanzeigen listing search
Classified listings on Kleinanzeigen (Germany) for keywords, with the site's filters: category, location and radius, price range, private or commercial sellers, offers or wanted ads, and sort (newest, lowest or highest price). Each listing: id, title, link, description snippet, price and label, negotiable (VB) and free flags, postal code and place, posting time, shipping and direct-buy flags, image and image count, shop link for commercial sellers. total is the site's count. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
qrequired | string | Keywords, e.g. iphone. Example: iphone |
category_id | string | The site's category number, e.g. 173 (phones), 217 (bicycles). |
location_id | string | The site's location number, e.g. 3331 (Berlin). |
radius | 5 | 10 | 20 | 30 | 50 | 100 | 150 | 200 | Kilometres around the location: 5, 10, 20, 30, 50, 100, 150, 200. |
price_min | string | Lowest price in euros. |
price_max | string | Highest price in euros. |
seller | private | commercial | private or commercial. |
ad_type | offer | wanted | offer (items offered) or wanted (people looking for an item). Default: both. |
sort | newest | price_asc | price_desc | newest (default), price_asc or price_desc. |
page | integer | Page number. Pass next_page from the previous response. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/kleinanzeigen/v1/search?q=iphone" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/kleinanzeigen/v1/search",
params={"q": "iphone"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/kleinanzeigen/v1/search");
url.searchParams.set("q", "iphone");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).