autoscout24.cz APIautoscout24.cz ↗
Search and retrieve European car listings from AutoScout24.cz. Filter by make, model, fuel, transmission, country, and price. 3 endpoints, full vehicle details.
curl -X GET 'https://api.parse.bot/scraper/6c748037-c16d-4187-b23b-698e47fb8669/search_listings?make=13&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for car listings on AutoScout24.cz with various filters. Returns paginated results from across Europe by default. When no country filter is specified, listings from all supported countries are returned.
| Param | Type | Description |
|---|---|---|
| desc | integer | Sort direction: 0 for ascending, 1 for descending. |
| fuel | string | Fuel type code: 'B' (Petrol), 'D' (Diesel), 'E' (Electric), 'L' (LPG), 'C' (CNG), 'H' (Hydrogen), 'M' (Ethanol). |
| gear | string | Transmission type code: 'A' (Automatic), 'M' (Manual). |
| make | string | Make ID (use get_taxonomy to find IDs). For example, '9' for Audi, '13' for BMW, '32' for Volkswagen. |
| page | integer | Page number for pagination. |
| sort | string | Sorting criteria: 'standard', 'price', 'mileage', 'age', 'firstregistration'. |
| model | string | Model ID within the selected make. |
| country | string | Country code filter. Accepted values include 'AT', 'BE', 'DE', 'ES', 'FR', 'IT', 'LU', 'NL'. Omitting returns listings from all of Europe. Note: some country codes like 'CZ' may return zero results depending on current inventory. |
| year_to | integer | Maximum year of first registration. |
| price_to | integer | Maximum price in EUR. |
| year_from | integer | Minimum year of first registration. |
| mileage_to | integer | Maximum mileage in km. |
| price_from | integer | Minimum price in EUR. |
| mileage_from | integer | Minimum mileage in km. |
{
"type": "object",
"fields": {
"listings": "array of listing objects with id, make, model, variant, price, price_raw, mileage, year, fuel, transmission, location, seller_name, seller_type, phones, url, images",
"total_pages": "integer, total number of pages available",
"current_page": "integer, current page number",
"total_results": "integer, total number of matching listings"
},
"sample": {
"data": {
"listings": [
{
"id": "edb2c755-e6cb-4270-a748-934a414bda19",
"url": "https://www.autoscout24.cz/nabidky/bmw-x3-xdrive30e-elektro-benzin-seda-edb2c755-e6cb-4270-a748-934a414bda19",
"fuel": "Elektro/Benzín",
"make": "BMW",
"year": "01-2023",
"model": "X3",
"price": "€ 44 990",
"images": [
"https://prod.pictures.autoscout24.net/listing-images/edb2c755-e6cb-4270-a748-934a414bda19_e3dd58fa-db0f-4290-9697-2eba29a777d3.jpg/250x188.webp"
],
"phones": [
"+43 (0)732 - 7980313"
],
"mileage": "47 000 km",
"variant": "X3",
"location": {
"zip": "4020",
"city": "Linz",
"street": "Estermannstraße 2-4",
"countryCode": "AT"
},
"price_raw": "44990",
"seller_name": "Höglinger Denzel GmbH",
"seller_type": "Dealer",
"transmission": "Automatická"
}
],
"total_pages": 200,
"current_page": 1,
"total_results": 161456
},
"status": "success"
}
}About the autoscout24.cz API
The AutoScout24.cz API provides access to car listings and vehicle details across Europe through 3 endpoints. Use search_listings to query the catalogue by make, model, fuel type, transmission, and country, then call get_listing_details with any listing URL to retrieve specs including power output, doors, seats, color, and formatted price. A get_taxonomy endpoint supplies the make IDs required by the search filters.
Search and Filter Listings
The search_listings endpoint accepts up to eight optional parameters. Pass a make ID (obtainable from get_taxonomy) and an optional model ID to narrow results to a specific vehicle line. Filter further with fuel codes (B for petrol, D for diesel, E for electric, and others), gear codes (A or M), and a country code such as DE, FR, or IT. Omitting country returns listings from all supported European markets. Results are paginated; the response includes total_pages, current_page, and total_results alongside the listings array. Each listing object carries id, make, model, variant, price, price_raw, mileage, year, fuel, transmission, location, and seller_name.
Listing Details
get_listing_details takes the url field from any listing returned by search_listings and returns a fuller record. Additional fields beyond the search summary include color, doors, seats, power (formatted as kW and hp), and title. Listings that have been removed or whose URLs have gone stale return an input_not_found error, so callers should handle that case when processing bulk URL sets.
Taxonomy
get_taxonomy requires no inputs and returns a sorted makes array where each entry has an id and a human-readable name. The id values map directly to the make parameter in search_listings. Examples from the endpoint description include 9 for Audi, 13 for BMW, and 32 for Volkswagen. Fetching taxonomy first and caching the result avoids hardcoding make IDs in your application.
- Build a cross-country price comparison tool using search_listings with different country codes and the price_raw field
- Track mileage and age distribution for a specific make/model combination across European markets
- Populate a used-car search widget with live results filtered by fuel type and transmission
- Monitor listing count changes for electric vehicles (fuel code 'E') over time
- Enrich a CRM or inventory system with full vehicle specs by calling get_listing_details on saved listing URLs
- Generate a make/model dropdown for a search UI by consuming the get_taxonomy response
- Alert users when new listings matching saved filters (make, model, country) appear in paginated results
| 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 offer an official developer API?+
Which countries are covered by the search_listings endpoint?+
country parameter accepts AT, BE, DE, ES, FR, IT, LU, and NL. Omitting it returns listings from all supported markets combined. Countries outside that set are not currently filterable through the parameter.What vehicle specification fields does get_listing_details return that search_listings does not?+
color, doors, seats, power (kW and hp), and title on top of the core fields already present in search results. Fields such as engine displacement, emissions rating, or full equipment lists are not currently returned. You can fork this API on Parse and revise it to add those fields if the source exposes them on the listing page.Can I retrieve seller contact information or phone numbers through this API?+
seller_name in search results but does not currently expose contact details such as phone numbers or email addresses. You can fork the API on Parse and revise it to add a seller contact endpoint if that data is available on the listing page.How should I handle pagination when iterating through a large result set?+
search_listings response includes total_pages and current_page fields. Increment the page parameter from 1 up to total_pages to walk through all results. Changing sort order or filters resets pagination context, so fix your filter parameters before iterating pages.