autoscout24.com APIautoscout24.com ↗
Search AutoScout24 car listings across Europe by make, model, price, fuel type, and more. Access vehicle taxonomy with makes and models via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/e78cd3f6-1aab-49ec-8344-854707ec80da/search_listings?make=BMW&page=1&model=3+Series&country=DE&max_pages=1&page_size=20' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for car listings on AutoScout24 with various filters including make, model, price range, year, fuel type, transmission, and country. Returns paginated results with listing details and metadata.
| Param | Type | Description |
|---|---|---|
| make | string | Car make (e.g., Volkswagen, BMW, Audi, Mercedes-Benz) |
| page | integer | Start page number |
| model | string | Car model (e.g., Golf, 3-series, A4) |
| country | string | ISO-2 country codes, comma-separated (e.g., DE,IT,FR). Supported: AT, BE, DE, ES, FR, IT, LU, NL |
| sort_by | string | Sort order: standard, price, price_desc, year, year_desc |
| year_to | string | Maximum year of first registration (e.g., 2023) |
| price_to | string | Maximum price in EUR |
| fuel_type | string | Fuel type code: D for Diesel, B for Gasoline, E for Electric, L for LPG, C for CNG, 2 for Ethanol, M for Hybrid |
| max_pages | integer | Maximum number of pages to scan |
| page_size | integer | Number of results per page (max 20) |
| year_from | string | Minimum year of first registration (e.g., 2018) |
| price_from | string | Minimum price in EUR |
| include_raw | boolean | Include raw JSON data from the site in each listing |
| transmission | string | Transmission type code: M for Manual, A for Automatic, S for Semi-automatic |
| exclude_damaged | boolean | Exclude damaged listings |
{
"type": "object",
"fields": {
"listings": "array of car listing objects with id, make, model, model_version, first_registration, price, mileage, fuel_type, transmission, location, seller_type, image_url, url, and contact",
"metadata": "object with current_page, page_size, scanned_pages, total_results, total_pages, and has_more"
},
"sample": {
"data": {
"listings": [
{
"id": "789e0935-8d48-49a7-b055-a12a9563d7ae",
"url": "https://www.autoscout24.com/offers/volkswagen-golf-example",
"make": "Volkswagen",
"model": "Golf",
"price": 1700,
"contact": {
"phones": [
"+49 1234 567890"
],
"company_name": "Autohaus Example GmbH",
"contact_name": "John Doe"
},
"mileage": 356000,
"location": "03222 Luebbenau, DE",
"fuel_type": "Diesel",
"image_url": "https://prod.pictures.autoscout24.net/listing-images/example.jpg",
"seller_type": "Dealer",
"transmission": "Manual",
"model_version": "VI Variant Trendline BlueMotion",
"first_registration": "12-2011"
}
],
"metadata": {
"has_more": true,
"page_size": 20,
"total_pages": 200,
"current_page": 1,
"scanned_pages": 1,
"total_results": 19391
}
},
"status": "success"
}
}About the autoscout24.com API
The AutoScout24 API covers 2 endpoints that expose European used and new car listings alongside the full vehicle taxonomy. The search_listings endpoint returns paginated results with fields including price, mileage, fuel type, transmission, and first registration year — filterable across 8 supported countries. The get_aggregations endpoint lets you enumerate all available makes and their corresponding models by numeric ID.
Search Car Listings
The search_listings endpoint accepts filters for make, model, country (ISO-2 codes from AT, BE, DE, ES, FR, IT, LU, NL), price_to, year_to, fuel_type, and sort_by. Fuel type codes map to common options: D for Diesel, B for Gasoline, E for Electric, L for LPG, C for CNG, and M for Hybrid. Each listing object in the response includes id, make, model, model_version, first_registration, price (in EUR), mileage, fuel_type, and transmission. The metadata object on every response reports current_page, total_results, total_pages, and has_more for straightforward pagination using the page parameter.
Vehicle Taxonomy
The get_aggregations endpoint operates in two modes. Set mode='makes' to retrieve the full list of car makes, each with a numeric id, a name string, and a label object containing an en_GB display string. Once you have a make_id, switch to mode='models' to pull the model list for that make. The vehicle_type parameter narrows results to either cars (C) or motorcycles (M). The metadata object returns a total count and confirms the active mode.
Coverage and Scope
Listing data covers AutoScout24's European inventory, with country filtering limited to the eight markets listed above. Prices are denominated in EUR. Sorting options include standard, price, price_desc, year, and year_desc, which controls the order listings are returned within pagination.
- Build a cross-country price comparison tool using
price_toandcountryfilters across DE, FR, and IT markets - Track average asking prices for a specific make/model combination over time using
search_listingswithsort_by=price - Populate make/model dropdowns in a car search UI using
get_aggregationsin bothmakesandmodelsmodes - Monitor Electric vehicle (
fuel_type=E) availability and pricing trends across European markets - Identify first-registration year distribution for a model using the
first_registrationfield across paginated results - Build a motorcycle inventory feed by combining
get_aggregationswithvehicle_type=Mand filteredsearch_listingscalls - Aggregate mileage and price data by transmission type to surface manual vs. automatic price differentials
| 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 | 250 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 AutoScout24 have an official developer API?+
What does the `search_listings` response include for each car?+
id, make, model, model_version, first_registration, price (EUR), mileage, fuel_type, and transmission. The response-level metadata object includes current_page, page_size, total_results, total_pages, and has_more to support pagination.Which countries are supported in the `country` filter?+
country parameter accepts comma-separated ISO-2 codes from eight markets: AT (Austria), BE (Belgium), DE (Germany), ES (Spain), FR (France), IT (Italy), LU (Luxembourg), and NL (Netherlands). Listings outside these markets are not returned.Does the API return dealer information or contact details for listings?+
search_listings response covers vehicle attributes like price, mileage, fuel type, and registration year, but does not include dealer name, dealer location, or contact details. You can fork this API on Parse and revise it to add an endpoint that retrieves listing detail pages including dealer information.Can I filter listings by mileage range?+
price_to and year_to but does not expose a mileage_to or mileage_from parameter. Mileage is present as a field in each returned listing object. You can fork this API on Parse and revise it to add mileage-range filter parameters to the search_listings endpoint.