Kleinanzeigen APIkleinanzeigen.de ↗
Search and retrieve classified listings from kleinanzeigen.de. Filter by keyword, category, and price. Get full details including attributes, images, and seller info.
What is the Kleinanzeigen API?
The kleinanzeigen.de API exposes 2 endpoints for accessing German classified ad listings across vehicles, real estate, jobs, and electronics. The search endpoint returns paginated listing summaries with price, location, and posting date, while the details endpoint delivers the full ad record including category-specific attributes, seller information, and image URLs for any individual listing by its numeric ID.
curl -X GET 'https://api.parse.bot/scraper/d241c6ed-2043-4910-81f4-9f5c346e2075/search?page=1&sort=SORTING_DATE&query=laptop&category=multimedia_elektronik&max_price=500&min_price=100&exclude_images=false' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for classified ad listings on kleinanzeigen.de with optional filters for category, price range, and sorting. Returns one page (up to about 25 listings, promoted listings included) of listing summaries including id, title, price, location, and snippet, plus total_results as reported by the site. At least one of query or category is required (otherwise stale_input). A combination that matches nothing (e.g. an electronics keyword inside the vehicles category) returns an empty listings array with total_results 0, which is a valid result. Pagination advances via the page parameter (default 1). Promoted/top listings may lack date_posted.
| Param | Type | Description |
|---|---|---|
| page | integer | Results page number. |
| sort | string | Sorting field. Use 'SORTING_DATE' for most recent first; omit for the site's default relevance ordering. |
| query | string | Search keyword (e.g. 'laptop', 'fahrrad', 'sofa'). |
| category | string | Category name or numeric site category ID (e.g. '161'). Known names: 'immobilien', 'mietwohnungen', 'haeuser_mieten', 'eigentumswohnungen', 'haeuser_kaufen', 'autos', 'jobs', 'multimedia_elektronik', 'handy_telekom'. Other category slugs are passed as URL path segments. |
| max_price | string | Maximum price filter value in EUR (whole number). |
| min_price | string | Minimum price filter value in EUR (whole number). |
| exclude_images | string | Set to 'true' to exclude thumbnail URLs from results. |
{
"type": "object",
"fields": {
"url": "string, the search URL used",
"listings": "array of listing summary objects containing id, url (full listing page URL), title, price, is_negotiable, location, zip_code, date_posted (absent on promoted listings), snippet, and optionally thumbnail",
"total_results": "integer or null, total number of matching listings as reported by the site"
},
"sample": {
"data": {
"url": "https://www.kleinanzeigen.de/s-multimedia-elektronik/preis:100:500/sortierung:neuste/laptop/k0c161",
"listings": [
{
"id": "3500713852",
"url": "https://www.kleinanzeigen.de/s-anzeige/2x32gb-ddr4-laptop-ram/3500713852-225-4250",
"price": "250 €",
"title": "2x32GB DDR4 Laptop RAM",
"snippet": "Verkaufe 2 x SK hynix 32GB 2Rx8 PC4 - 3200AA - SE1 - 11 Arbeitsspeicher. Da dies ein Privatverkauf...",
"location": "04205 Grünau-Mitte",
"zip_code": "04205",
"thumbnail": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/ee/eedac8b5-d3cb-4304-9edb-98cc5127f4ce?rule=$_2.AUTO",
"is_negotiable": false
},
{
"id": "3506867833",
"url": "https://www.kleinanzeigen.de/s-anzeige/dell-latitude-5480-16gb-ram-256gb-nvme-ssd-full-hd-window/3506867833-278-9362",
"price": "150 € VB",
"title": "Dell Latitude 5480 | 16GB RAM | 256GB NVMe SSD | Full HD | Window",
"snippet": "Ich verkaufe meinen Dell Latitude 5480 in voll funktionsfähigem Zustand. Das Notebook wurde von...",
"location": "79108 Freiburg im Breisgau",
"zip_code": "79108",
"thumbnail": "https://img.kleinanzeigen.de/api/v1/prod-ads/images/cf/cfcff85c-9905-4f0e-8f5b-70bf45335cf2?rule=$_2.AUTO",
"date_posted": "Heute, 11:22",
"is_negotiable": true
}
],
"total_results": 32744
},
"status": "success"
}
}About the Kleinanzeigen API
Search Endpoint
The search endpoint accepts a query string (e.g. 'laptop', 'fahrrad') alongside optional filters: category (by name such as 'immobilien' or 'mietwohnungen', or a numeric ID), min_price and max_price for price bounding, sort for ordering (e.g. 'SORTING_DATE' to get most recent first), and a page integer for pagination. Each result in the listings array includes the listing id, url, title, price, is_negotiable flag, location, zip_code, date_posted, a short snippet, and seller handle (op). The total_results field gives the total match count for the query. Pass exclude_images=true to drop thumbnail URLs and reduce payload size.
Details Endpoint
The details endpoint takes a single required parameter, ad_id, and returns the full listing record. Response fields include title, price, description, location, images (an array of full-resolution URLs), seller_name, and seller_since. The attributes object contains category-specific key-value pairs — for vehicle listings these include fields like Kilometerstand (mileage) and Marke (brand); real estate listings expose different attribute sets. Pass exclude_images=true to omit the images array when image data is not needed.
Coverage and Categories
Kleinanzeigen.de is Germany's largest general classifieds platform. The API covers all major listing verticals accessible through the site: vehicles, real estate (rental apartments, houses, owner-occupied flats), electronics, furniture, jobs, and general merchandise. Category filtering uses either human-readable names ('haeuser_mieten', 'eigentumswohnungen') or numeric IDs where known. Pagination is handled via the page parameter on the search endpoint.
The Kleinanzeigen API is a managed, monitored endpoint for kleinanzeigen.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when kleinanzeigen.de changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official kleinanzeigen.de API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track used car listings by filtering on
categoryandmin_price/max_priceto monitor price trends for specific makes - Aggregate rental apartment listings in a target city using the
'mietwohnungen'category and location-based queries - Build a price-drop alert system by periodically querying
searchand comparingpricefields across runs - Enrich a CRM with seller history by pulling
seller_sinceandseller_namefrom thedetailsendpoint - Index full listing descriptions and category
attributes(e.g. mileage, brand) for search or ML pipelines - Compile electronics inventory datasets by querying product keywords and extracting
priceandis_negotiableflags
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does kleinanzeigen.de have an official developer API?+
What does the `details` endpoint return beyond what `search` provides?+
details endpoint returns the full listing description text, all full-resolution image URLs, the attributes object with category-specific fields (e.g. vehicle mileage and brand, or real estate specifics), seller_name, and seller_since. The search endpoint returns only a short snippet, a thumbnail, and summary fields like price, location, and date_posted.Can I filter search results by geographic area or postal code?+
search endpoint does not currently expose a dedicated location or radius filter parameter. Results include zip_code and location fields per listing. You can fork this API on Parse and revise it to add a location-based filter parameter.Does the API return seller contact details such as phone numbers or email addresses?+
details endpoint exposes seller_name and seller_since only. Phone numbers and email addresses gated behind login or contact-reveal flows on the site are not included. You can fork the API on Parse and revise it to add additional seller-side fields if those become accessible.How does pagination work on the `search` endpoint?+
page parameter accepts an integer to step through result pages. The total_results field in the response gives the total count of matched listings, which you can use to calculate how many pages exist for a given query. Note that total_results may return null for some queries.