AutoScout24 APIautoscout24.de ↗
Search AutoScout24.de used and new car listings by make, model, price, and country. Fetch full listing details including seller info, mileage, and specs.
What is the AutoScout24 API?
The AutoScout24.de API provides 2 endpoints to search and retrieve car listings from Europe's AutoScout24 marketplace. The search_listings endpoint returns paginated results filtered by make, model, price range, first-registration year, and country, while get_listing_details delivers a full record for any single listing including seller name and location, body type, fuel type, gearbox, power output, and the seller's own description text.
curl -X GET 'https://api.parse.bot/scraper/1e41d6bc-ee9a-4be6-adc1-c7dcb94586af/search_listings?make=bmw&model=3er&country=DE&price_max=15000' \ -H 'X-API-Key: $PARSE_API_KEY'
Searches car listings and returns one page of results in the site's default 'best results' order. Each item is one listing with title, make, model, first-registration year, mileage (km), fuel, gearbox, power (hp), price with currency, seller type (Dealer or PrivateSeller), country code, city and the listing URL; the free-text seller description is not shown on the results page and is available per listing via get_listing_details using listing_id. Filters: make/model are the site's URL slugs (lowercase, hyphenated, e.g. make 'mercedes-benz' with model 'c-200' as one shape); model requires make. country restricts to a single country; omitted means all of Europe. price_min/price_max are in EUR, year_min/year_max are first-registration years. Pagination: one upstream request per call; page defaults to 1 and page_size defaults to 20 (accepted 1-50, verified with 5, 10, 20 and 50); total, total_pages and has_more come from the site. An unknown make or model slug returns a stale_input (input_not_found) error; a filter combination with no matches returns an empty listings array.
| Param | Type | Description |
|---|---|---|
| make | string | Make slug as used in the site's URLs: lowercase, spaces as hyphens (e.g. bmw, mercedes-benz). |
| page | integer | 1-based result page number. |
| model | string | Model or model-group slug as used in the site's URLs (e.g. 3er for the BMW 3 series, c-200 for Mercedes-Benz C 200). Requires make. |
| country | string | Restrict results to one country (ISO 3166-1 alpha-2). Omitted = all countries the site covers. |
| year_max | integer | Latest first-registration year (inclusive). |
| year_min | integer | Earliest first-registration year (inclusive), e.g. 2010. |
| page_size | integer | Listings per page, 1 to 50. |
| price_max | integer | Maximum price in EUR (inclusive). |
| price_min | integer | Minimum price in EUR (inclusive). |
{
"type": "object",
"fields": {
"page": "page returned",
"total": "total matching listings reported by the site",
"has_more": "true when page < total_pages",
"listings": "array of listing summaries: listing_id (UUID, input for get_listing_details), title (make + model), subtitle (seller's version text), make, model, year (first registration), mileage_km, fuel, gearbox, power_hp, price (number), currency (ISO code), seller_type (Dealer | PrivateSeller), country (ISO alpha-2), city, listing_url",
"page_size": "requested page size",
"total_pages": "number of pages the site reports for this page_size"
},
"sample": {
"data": {
"page": 2,
"total": 1411,
"has_more": true,
"listings": [
{
"city": "Diepholz",
"fuel": "Diesel",
"make": "BMW",
"year": 2010,
"model": "320",
"price": 11999,
"title": "BMW 320",
"country": "DE",
"gearbox": "Schaltgetriebe",
"currency": "EUR",
"power_hp": 184,
"subtitle": "3 Limousine 320 d*M-PAKET*2.HAND*SCHECKHEFTG",
"listing_id": "b28da19d-db94-4869-953d-d5f7fc68007b",
"mileage_km": 135000,
"listing_url": "https://www.autoscout24.de/angebote/bmw-3er-3-limousine-320-d-m-paket-2-hand-scheckheftg-diesel-schwarz-cat_ma13gr100038ge25va105mt118tr479990-b28da19d-db94-4869-953d-d5f7fc68007b",
"seller_type": "Dealer"
}
],
"page_size": 10,
"total_pages": 142
},
"status": "success"
}
}About the AutoScout24 API
Search Listings
The search_listings endpoint accepts up to eight filter parameters. make and model take URL-style slugs (e.g. bmw, 3er; mercedes-benz, c-200). country takes an ISO 3166-1 alpha-2 code to restrict results to a single market — omit it to search across all countries AutoScout24 covers. price_max is in EUR. year_min and year_max filter by first-registration year. Results come back paginated: the response includes total, total_pages, has_more, and a listings array. Each listing summary carries a listing_id (UUID) that feeds directly into get_listing_details.
Listing Details
get_listing_details takes a single required input — the listing_id UUID from a search result — and returns the full record. Fields include title, make, model, year, mileage_km, fuel, gearbox, power_hp, body_type, price, currency, seller type (Dealer or PrivateSeller), seller name, country, city, zip, and the seller's free-text description. Fuel and gearbox labels are returned in German as displayed on the site (e.g. "Benzin", "Automatik").
Coverage and Scope
AutoScout24.de lists inventory from multiple EU countries. The country parameter in search_listings lets you target one market at a time; without it, results draw from the full cross-border inventory the site indexes. Listings include both dealer stock and private seller listings, distinguishable via the seller_type field returned by both endpoints.
The AutoScout24 API is a managed, monitored endpoint for autoscout24.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when autoscout24.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 autoscout24.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?+
- Build a price-tracking tool for a specific make/model across EU markets using
price_max,year_min, andcountryfilters. - Aggregate dealer inventory by filtering
seller_typeto Dealer and paginating throughsearch_listingsresults. - Compare asking prices for the same model in different countries by running parallel queries with different
countryvalues. - Feed a used-car valuation model with
mileage_km,power_hp,year, andpricefields from bulk search results. - Display full listing detail pages in a third-party app using
get_listing_detailsfor specs, seller name, and description text. - Monitor private seller listings for a target model by filtering
seller_typeand alerting on newlisting_identries across pages.
| 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 AutoScout24 have an official developer API?+
What does `search_listings` return for each result, and how is it different from `get_listing_details`?+
listings array from search_listings is a summary: title, make, model, year, mileage_km, fuel, gearbox, power_hp, price, currency, seller type, country, and the listing UUID. get_listing_details adds body_type, seller name, city, zip, and the seller's free-text description — fields not included in the search summary.Are results sorted or can I change the sort order?+
search_listings endpoint returns results in the site's default 'best results' order. No sort parameter is exposed. The API covers filtering by price, year, make, model, country, and pagination. You can fork it on Parse and revise to add a sort parameter if you need price-ascending or newest-first ordering.Is there a minimum price filter, or only a maximum?+
price_max for an upper price bound but does not include a price_min parameter. You can fork the API on Parse and revise it to add a minimum price filter.