{"id":"e22ce824-487b-4c4c-b4b0-bba1efbe9786","slug":"autoscout24-com-api","name":"autoscout24.com API","description":"Scrapes AutoScout24 to return car listings with full vehicle details (make, model, year, price, mileage, fuel type, transmission, location, seller type, and images). Supports filtering by make, model, year range, price range, fuel type, transmission, country, and damage status. Includes pagination and sorting controls, aggregation endpoints for browsing available makes and models, synonym normalization (e.g. 'VW' → 'volkswagen'), multi-country scanning via comma-separated ISO-2 codes, and response metadata for efficient client-side filtering.","front_facing_description":"Search millions of car listings on AutoScout24 and filter results by make, model, price, mileage, and other vehicle specifications. Explore vehicle taxonomy and aggregated data to discover market trends and compare automotive options across Europe's largest car marketplace.","source_url":"https://autoscout24.com","is_authenticated":false,"canonical_scraper_id":"e78cd3f6-1aab-49ec-8344-854707ec80da","apis":[{"method":"GET","endpoint_name":"search_listings","description":"Search for car listings on AutoScout24 with filters for make, model, price range, year, fuel type, transmission, and country. Returns paginated results with listing details including price, mileage, seller contact, and location. Pagination is manual via page/max_pages params; each page returns up to page_size results. The total_results in metadata reflects the full result set on the server.","input_params":{"make":{"type":"string","required":false,"description":"Car make (e.g., Volkswagen, BMW, Audi, Mercedes-Benz)","domain":{"kind":"large_enum","sample":["BMW","Audi","Volkswagen","Mercedes-Benz","Toyota"],"example":"BMW","pattern":"^[A-Za-z\\- ]+$","generator":{"type":"sample_pick"}}},"page":{"type":"integer","required":false,"description":"Start page number","default":1,"domain":{"kind":"open","example":1,"generator":{"type":"static","value":1}}},"model":{"type":"string","required":false,"description":"Car model (e.g., Golf, 3-series, A4)","domain":{"kind":"open","example":"3","generator":{"type":"static","value":"3"}}},"country":{"type":"string","required":false,"description":"ISO-2 country code or comma-separated codes (e.g., DE or DE,IT,FR). Supported: AT, BE, DE, ES, FR, IT, LU, NL","enum":"Country","domain":{"kind":"enum","values":["AT","BE","DE","ES","FR","IT","LU","NL"],"generator":{"type":"enum_pick","strategy":"first"}}},"sort_by":{"type":"string","required":false,"description":"Sort order for results","default":"standard","enum":"Sort","domain":{"kind":"enum","values":["standard","price","price_desc","year","year_desc"],"generator":{"type":"enum_pick","strategy":"first"}}},"year_to":{"type":"string","required":false,"description":"Maximum year of first registration (e.g., 2025)","domain":{"kind":"open","example":"2025","generator":{"type":"static","value":"2025"}}},"price_to":{"type":"string","required":false,"description":"Maximum price in EUR","domain":{"kind":"open","example":"50000","generator":{"type":"static","value":"50000"}}},"fuel_type":{"type":"string","required":false,"description":"Fuel type code","enum":"FuelType","domain":{"kind":"enum","values":["D","B","E","L","C","2","M"],"generator":{"type":"enum_pick","strategy":"first"}}},"max_pages":{"type":"integer","required":false,"description":"Maximum number of pages to scan","default":1,"domain":{"kind":"open","example":1,"generator":{"type":"static","value":1}}},"page_size":{"type":"integer","required":false,"description":"Number of results per page (max 20)","default":20,"domain":{"kind":"open","example":20,"generator":{"type":"static","value":20}}},"year_from":{"type":"string","required":false,"description":"Minimum year of first registration (e.g., 2018)","domain":{"kind":"open","example":"2018","generator":{"type":"static","value":"2018"}}},"price_from":{"type":"string","required":false,"description":"Minimum price in EUR","domain":{"kind":"open","example":"5000","generator":{"type":"static","value":"5000"}}},"include_raw":{"type":"boolean","required":false,"description":"Include raw JSON data from the site in each listing","default":false,"domain":{"kind":"open","example":false,"generator":{"type":"static","value":false}}},"transmission":{"type":"string","required":false,"description":"Transmission type code","enum":"Transmission","domain":{"kind":"enum","values":["M","A","S"],"generator":{"type":"enum_pick","strategy":"first"}}},"exclude_damaged":{"type":"boolean","required":false,"description":"Exclude damaged listings","default":true,"domain":{"kind":"open","example":true,"generator":{"type":"static","value":true}}}},"return_schema":{"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":"b1501d52-11ae-4488-9a42-1b97dd709c6b","url":"https://www.autoscout24.com/offers/bmw-116-example","make":"BMW","model":"116","price":4950,"contact":{"phones":["+49 (0)163 - 1234567"],"company_name":"Example Auto GmbH","contact_name":"Sales Team"},"mileage":104500,"location":"59557 Lippstadt, DE","fuel_type":"Gasoline","image_url":"https://prod.pictures.autoscout24.net/listing-images/example.jpg/250x188.webp","seller_type":"Dealer","transmission":"Manual","model_version":"i Sport Line","first_registration":"08-2011"}],"metadata":{"has_more":true,"page_size":20,"total_pages":200,"current_page":1,"scanned_pages":1,"total_results":19020}},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.data.listings","op":"array_min_len","value":1},{"path":"$.data.metadata.total_results","op":"not_null"},{"path":"$.data.listings[0].id","op":"not_null"},{"path":"$.data.listings[0].make","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_aggregations","description":"Get unique car makes or models using the AutoScout24 taxonomy API. Use mode='makes' to list all available makes, or mode='models' with a make_id to list models for a specific make. The make_id is obtained from a prior get_aggregations call with mode='makes' (items[*].id).","input_params":{"mode":{"type":"string","required":false,"description":"Aggregation mode: makes or models. Defaults to 'models' if make_id is provided, otherwise 'makes'.","default":"makes","enum":"AggregationMode","domain":{"kind":"enum","values":["makes","models"],"generator":{"type":"enum_pick","strategy":"first"}}},"make_id":{"type":"string","required":false,"description":"Numeric make ID (required when mode='models'). Obtain from get_aggregations with mode='makes' in items[*].id.","domain":{"kind":"open","example":"13","generator":{"type":"static","value":"13"}}},"vehicle_type":{"type":"string","required":false,"description":"Vehicle type","default":"C","enum":"VehicleType","domain":{"kind":"enum","values":["C","M"],"generator":{"type":"enum_pick","strategy":"first"}}}},"return_schema":{"type":"object","fields":{"items":"array of objects with id (integer), name (string), and label (object with en_GB string)","metadata":"object with total (integer count of items) and mode (string, either 'makes' or 'models')"},"sample":{"data":{"items":[{"id":51539,"name":"9ff","label":{"en_GB":"9ff"}},{"id":16396,"name":"Abarth","label":{"en_GB":"Abarth"}},{"id":13,"name":"BMW","label":{"en_GB":"BMW"}}],"metadata":{"mode":"makes","total":288}},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.data.items","op":"array_min_len","value":1},{"path":"$.data.metadata.total","op":"not_null"},{"path":"$.data.items[0].id","op":"not_null"},{"path":"$.data.items[0].name","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"search_listings":{"make":"BMW","page":"1","model":"3","country":"AT","sort_by":"standard","year_to":"2025","price_to":"50000","fuel_type":"D","max_pages":"1","page_size":"20","year_from":"2018","price_from":"5000","include_raw":"False","transmission":"M","exclude_damaged":"True"},"get_aggregations":{"mode":"makes","make_id":"13","vehicle_type":"C"}},"prefill_inputs":{"search_listings":{"make":"BMW","page":"1","model":"3","country":"AT","sort_by":"standard","year_to":"2025","price_to":"50000","fuel_type":"D","max_pages":"1","page_size":"20","year_from":"2018","price_from":"5000","include_raw":"False","transmission":"M","exclude_damaged":"True"},"get_aggregations":{"mode":"makes","make_id":"13","vehicle_type":"C"}},"last_verified_at":"2026-10-28T12:02:25.21189+00:00","endpoint_health":[{"endpoint_name":"search_listings","status":"healthy","last_checked_at":"2026-10-28T12:02:25.21189+00:00","last_verified_at":"2026-10-28T12:02:25.21189+00:00","recent_runs":[{"at":"2026-10-28T12:02:25.211890+00:00","status":"healthy"},{"at":"2026-10-21T11:05:52.881956+00:00","status":"healthy"},{"at":"2026-10-14T11:03:52.929364+00:00","status":"healthy"},{"at":"2026-10-07T10:03:52.897381+00:00","status":"healthy"},{"at":"2026-09-30T10:00:53.026963+00:00","status":"healthy"}]},{"endpoint_name":"get_aggregations","status":"healthy","last_checked_at":"2026-10-28T12:02:25.21189+00:00","last_verified_at":"2026-10-28T12:02:25.21189+00:00","recent_runs":[{"at":"2026-10-28T12:02:25.211890+00:00","status":"healthy"},{"at":"2026-10-21T11:05:52.881956+00:00","status":"healthy"},{"at":"2026-10-14T11:03:52.929364+00:00","status":"healthy"},{"at":"2026-10-07T10:03:52.897381+00:00","status":"healthy"},{"at":"2026-09-30T10:00:53.026963+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: AutoScout24 SDK — search listings, explore taxonomy, drill into models.\"\"\"\nfrom parse_apis.autoscout24_api import AutoScout24, Sort, FuelType, Country, VehicleType, MakeIdRequired\n\nclient = AutoScout24()\n\n# List available car makes from the taxonomy\nfor make in client.makes.list(limit=5):\n    print(make.name, make.id)\n\n# Construct a known make and list its models\nbmw = client.make(id=13)\nfor model in bmw.models(vehicle_type=VehicleType.CAR, limit=3):\n    print(model.name, model.id, model.label.en_GB)\n\n# Search listings with filters — sort by price, diesel, in Germany\nlisting = client.listings.search(\n    make=\"BMW\",\n    country=Country.DE,\n    fuel_type=FuelType.DIESEL,\n    sort_by=Sort.PRICE,\n    limit=1,\n).first()\n\nif listing:\n    print(listing.make, listing.model, listing.price, listing.mileage)\n    print(listing.location, listing.seller_type)\n    print(listing.contact.company_name, listing.contact.phones)\n\n# Typed error handling\ntry:\n    for m in client.make(id=99999).models(limit=1):\n        print(m.name)\nexcept MakeIdRequired as exc:\n    print(f\"Error: {exc}\")\n\nprint(\"exercised: makes.list / make.models / listings.search / error handling\")\n","shape":"parse_sdk","endpoints":["search_listings","get_aggregations"],"has_session":false,"hover_map":[{"line":7,"col":4,"len":4,"label":"make: Make","kind":"variable"},{"line":12,"col":4,"len":5,"label":"model: Model","kind":"variable"},{"line":16,"col":0,"len":7,"label":"listing: Listing","kind":"variable"},{"line":24,"col":3,"len":7,"label":"listing: Listing","kind":"variable"},{"line":4,"col":9,"len":11,"label":"AutoScout24 — API client","kind":"class"},{"line":7,"col":25,"len":4,"label":"list() → List[Make]","kind":"method"},{"line":12,"col":17,"len":6,"label":"models() → List[Model]","kind":"method"},{"line":31,"col":8,"len":1,"label":"m: Model","kind":"variable"},{"line":33,"col":7,"len":14,"label":"MakeIdRequired — error: mode='models' requested without providing make_id","kind":"error"},{"line":8,"col":15,"len":4,"label":"name: str","kind":"field"},{"line":8,"col":26,"len":2,"label":"id: int","kind":"field"},{"line":12,"col":49,"len":3,"label":"VehicleType.CAR","kind":"enum-member"},{"line":13,"col":16,"len":4,"label":"name: str","kind":"field"},{"line":13,"col":28,"len":2,"label":"id: int","kind":"field"},{"line":13,"col":44,"len":5,"label":"en_GB: Optional[str]","kind":"field"},{"line":25,"col":18,"len":4,"label":"make: str","kind":"field"},{"line":25,"col":32,"len":5,"label":"model: str","kind":"field"},{"line":25,"col":47,"len":5,"label":"price: Optional[int]","kind":"field"},{"line":25,"col":62,"len":7,"label":"mileage: Optional[int]","kind":"field"},{"line":26,"col":18,"len":8,"label":"location: Optional[str]","kind":"field"},{"line":26,"col":36,"len":11,"label":"seller_type: Optional[str]","kind":"field"},{"line":27,"col":26,"len":12,"label":"company_name: Optional[str]","kind":"field"},{"line":27,"col":56,"len":6,"label":"phones: List[str]","kind":"field"},{"line":31,"col":35,"len":6,"label":"models() → List[Model]","kind":"method"},{"line":8,"col":10,"len":4,"label":"make: Make","kind":"variable"},{"line":8,"col":21,"len":4,"label":"make: Make","kind":"variable"},{"line":12,"col":37,"len":11,"label":"VehicleType — enum: CAR, MOTORCYCLE","kind":"enum"},{"line":13,"col":10,"len":5,"label":"model: Model","kind":"variable"},{"line":13,"col":22,"len":5,"label":"model: Model","kind":"variable"},{"line":13,"col":38,"len":5,"label":"label: Label","kind":"field"},{"line":16,"col":26,"len":6,"label":"search() → List[Listing]","kind":"method"},{"line":25,"col":10,"len":7,"label":"listing: Listing","kind":"variable"},{"line":25,"col":24,"len":7,"label":"listing: Listing","kind":"variable"},{"line":25,"col":39,"len":7,"label":"listing: Listing","kind":"variable"},{"line":25,"col":54,"len":7,"label":"listing: Listing","kind":"variable"},{"line":26,"col":10,"len":7,"label":"listing: Listing","kind":"variable"},{"line":26,"col":28,"len":7,"label":"listing: Listing","kind":"variable"},{"line":27,"col":18,"len":7,"label":"contact: Contact","kind":"field"},{"line":27,"col":48,"len":7,"label":"contact: Contact","kind":"field"},{"line":32,"col":16,"len":4,"label":"name: str","kind":"field"},{"line":13,"col":32,"len":5,"label":"model: Model","kind":"variable"},{"line":18,"col":20,"len":2,"label":"Country.DE","kind":"enum-member"},{"line":19,"col":23,"len":6,"label":"FuelType.DIESEL","kind":"enum-member"},{"line":20,"col":17,"len":5,"label":"Sort.PRICE","kind":"enum-member"},{"line":27,"col":10,"len":7,"label":"listing: Listing","kind":"variable"},{"line":27,"col":40,"len":7,"label":"listing: Listing","kind":"variable"},{"line":32,"col":14,"len":1,"label":"m: Model","kind":"variable"},{"line":18,"col":12,"len":7,"label":"Country — enum: AT, BE, DE, ES, FR, IT…","kind":"enum"},{"line":19,"col":14,"len":8,"label":"FuelType — enum: CNG, DIESEL, ELECTRIC, ETHANOL, GASOLINE, HYBRID…","kind":"enum"},{"line":20,"col":12,"len":4,"label":"Sort — enum: PRICE, PRICE_DESC, STANDARD, YEAR, YEAR_DESC","kind":"enum"},{"line":34,"col":20,"len":3,"label":"exc: MakeIdRequired","kind":"variable"}]},"sdk_delivery_state":"legacy","summary":"Search car listings and explore vehicle taxonomy on AutoScout24, Europe's largest online car market.","updated_at":"2026-07-23T02:47:23.257015+00:00","user_variants":[],"latest_version":5,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"AutoScout24 does not offer a public developer API for listing search or vehicle taxonomy. Their official developer resources at developer.autoscout24.com are oriented toward dealer integrations, not general data access.","q":"Does AutoScout24 have an official developer API?"},{"a":"With `mode='makes'`, `get_aggregations` returns every make available on AutoScout24 as an array with `id`, `name`, and `label.en_GB`. You then pass one of those `id` values as `make_id` with `mode='models'` to get that make's model list. The `name` values from those responses map directly to the `make` and `model` parameters in `search_listings`.","q":"What does `get_aggregations` return and how do I use it with `search_listings`?"},{"a":"The `country` parameter supports eight markets: AT (Austria), BE (Belgium), DE (Germany), ES (Spain), FR (France), IT (Italy), LU (Luxembourg), and NL (Netherlands). Other European markets where AutoScout24 operates, such as Poland or Portugal, are not currently supported by this parameter.","q":"Which countries does the `search_listings` endpoint cover?"},{"a":"The `listings` array includes seller location and contact fields alongside `price`, `mileage`, `fuel_type`, `transmission`, and `first_registration`. Detailed technical specifications such as engine displacement, power output, or full equipment lists are not currently returned. You can fork this API on Parse and revise it to add an endpoint that fetches the individual listing detail page for those fields.","q":"Does the API return seller contact details or full vehicle specs beyond mileage and fuel type?"},{"a":"Pagination is manual. You control the starting point with the `page` parameter and can cap how many pages are fetched with `max_pages`. The `metadata` object in each response includes `current_page`, `total_pages`, and `has_more`, so you can iterate until `has_more` is false or your desired page limit is reached.","q":"How does pagination work in `search_listings`?"}],"keywords":["autoscout24 api","europe used car listings api","car search api germany france","autoscout24 vehicle data api","used car price api europe","car make model taxonomy api","autoscout24 scraper api","automotive listings api eur","vehicle search filter api","autoscout24 mileage price data","european car marketplace api","car fuel type transmission api","autoscout24 pagination api","car listing aggregation api"],"use_cases":["Track EUR price distributions for a specific make/model combination across multiple European countries","Build a used-car price alert tool filtering by `year_to`, `price_to`, and `fuel_type`","Populate a vehicle selector UI with valid make/model pairs using chained `get_aggregations` calls","Compare average mileage for the same model listed in DE versus FR or IT","Monitor new listings for a specific `make` and `model` by polling `search_listings` with `has_more` pagination","Analyze fuel type distribution across listings in a given country using aggregated search results","Identify transmission preferences by market using `transmission` field across country-scoped searches"],"meta_title":"AutoScout24 API – Car Listings & Vehicle Data","generated_at":"2026-06-11T04:53:20.267608+00:00","lead_paragraph":"The AutoScout24 API provides access to 2 endpoints covering millions of European car listings and the full vehicle taxonomy. The `search_listings` endpoint returns paginated results with fields including price, mileage, fuel type, transmission, first registration date, and seller location. The `get_aggregations` endpoint exposes the complete list of makes and their associated models, using numeric IDs to chain calls.","schema_version":2,"meta_description":"Search AutoScout24 car listings across Europe. Filter by make, model, price, fuel type, and country. Explore vehicle taxonomy with makes and models endpoints.","primary_category":"automotive","long_description_md":"## Search Car Listings\n\nThe `search_listings` endpoint accepts filters for `make`, `model`, `country` (ISO-2 codes; AT, BE, DE, ES, FR, IT, LU, NL supported), `price_to`, `year_to`, `fuel_type`, and `transmission`. Each listing object in the `listings` array includes `id`, `make`, `model`, `model_version`, `first_registration`, `price`, `mileage`, `fuel_type`, `transmission`, and location data. The `metadata` object returns `current_page`, `page_size`, `total_results`, `total_pages`, and `has_more` for manual pagination control via the `page` and `max_pages` parameters.\n\n## Vehicle Taxonomy via Aggregations\n\nThe `get_aggregations` endpoint resolves the AutoScout24 vehicle hierarchy. Call it with `mode='makes'` to retrieve all available makes as an array of objects containing `id` (integer), `name`, and `label.en_GB`. Pass a `make_id` obtained from that response into a second call with `mode='models'` to list all models for that make. The `metadata` field returns the `total` count of items and confirms which `mode` was used. This two-step lookup ensures `make` and `model` values passed to `search_listings` are valid.\n\n## Coverage and Filtering Notes\n\nCountry coverage is limited to eight European markets: Austria, Belgium, Germany, Spain, France, Italy, Luxembourg, and the Netherlands. The `country` parameter accepts a single ISO-2 code or a comma-separated list (e.g., `DE,FR,IT`) to broaden a search across markets. Listings are denominated in EUR. Sort order is controlled via `sort_by`, though the available sort codes should be verified against actual AutoScout24 sort options.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["marketplace","ecommerce"]},"primary_category":"automotive","secondary_categories":["marketplace","ecommerce"],"access_requirements":[]}