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=autos&max_price=500&min_price=100&exclude_images=false' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace kleinanzeigen-de-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Kleinanzeigen.de SDK — search listings and drill into details."""
from parse_apis.kleinanzeigen.de_scraper_api import Kleinanzeigen, Sort, Category, ListingNotFound
client = Kleinanzeigen()
# Search for laptops in electronics category, sorted by most recent
for item in client.listingsummaries.search(query="laptop", category=Category.MULTIMEDIA_ELEKTRONIK, sort=Sort.DATE, limit=5):
print(item.title, item.price, item.location)
# Drill into the first result to get full details
summary = client.listingsummaries.search(query="fahrrad", limit=1).first()
if summary:
listing = summary.details()
print(listing.title, listing.price, listing.description[:100])
print(listing.seller_name, listing.seller_since)
# Direct lookup by ID
try:
detail = client.listings.get(id="3418849198")
print(detail.title, detail.price, detail.location)
for key, val in detail.attributes.items():
print(key, val)
except ListingNotFound as exc:
print(f"Listing gone: {exc}")
print("exercised: listingsummaries.search / summary.details / listings.get")
Search for classified ad listings on kleinanzeigen.de with optional filters for category, price range, and sorting. Returns paginated results with listing summaries including title, price, location, and snippet. At least one of query or category should be provided for meaningful results. Pagination advances via the page parameter. 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. |
| query | string | Search keyword (e.g. 'laptop', 'fahrrad', 'sofa'). |
| category | string | Category name or numeric ID. 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. |
| min_price | string | Minimum price filter value. |
| 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, title, price, is_negotiable, location, zip_code, date_posted, snippet, and optionally thumbnail",
"total_results": "integer or null, total number of matching listings"
},
"sample": {
"data": {
"url": "https://www.kleinanzeigen.de/s-laptop/k0",
"listings": [
{
"id": "3432271978",
"url": "https://www.kleinanzeigen.de/s-anzeige/3432271978",
"price": "79 € VB",
"title": "Lenovo Laptop ohne Akku, i5 NVIDIA 500GB SSD 8GB + mass. Zubehör",
"snippet": "Ich biete hier mein Lenovo G710 Notebook an...",
"location": "12623 Hellersdorf",
"zip_code": "12623",
"date_posted": "Heute, 10:36",
"is_negotiable": true
}
],
"total_results": 121393
},
"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 | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. 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.