autoscout24.it APIautoscout24.it ↗
Search AutoScout24.it car listings, get vehicle details, browse dealer profiles, and resolve makes and models via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/7727452e-c057-448b-91dd-43798490efb8/search_listings?make=28&model=1746&condition=N%2CU' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for car listings with various filters including make, model, price, year, fuel type, etc. Returns paginated results up to 200 pages. Some filter combinations may return empty results if no matching listings exist.
| Param | Type | Description |
|---|---|---|
| make | string | Make ID as a numeric string (e.g., '9' for Audi, '28' for Fiat). Obtain IDs from get_makes_list endpoint. |
| page | integer | Page number, maximum 200. |
| sort | string | Sort order: 'standard', 'price', 'mileage'. |
| model | string | Model ID as a numeric string (e.g., '1746' for Panda). Obtain IDs from get_models_by_make endpoint. |
| year_to | integer | Maximum registration year (e.g., 2024). |
| price_to | integer | Maximum price in EUR. |
| body_type | string | Vehicle body type code (e.g., 'Berlina', 'SUV/Fuoristrada'). |
| condition | string | Vehicle condition filter: 'N' for New, 'U' for Used, or 'N,U' for both. |
| fuel_type | string | Fuel type code (e.g., 'Benzina', 'Diesel', 'Elettrica', 'Elettrica/Benzina'). Not all combinations have listings. |
| year_from | integer | Minimum registration year (e.g., 2020). |
| price_from | integer | Minimum price in EUR. |
| transmission | string | Transmission type: 'Manuale' or 'Automatico'. |
| vehicle_type | string | Vehicle type: 'C' for Car, 'M' for Motorcycle, 'V' for Van. |
{
"type": "object",
"fields": {
"listings": "array of listing objects with id, slug, make, model, variant, price, mileage, year, fuel, transmission, location, images, dealer, is_new, details_summary",
"total_pages": "integer total number of pages",
"current_page": "integer current page number",
"total_results": "integer total number of matching listings"
},
"sample": {
"data": {
"listings": [
{
"id": "fe5e7300-1f6d-49cd-992f-bdbeec314f32",
"fuel": "Benzina",
"make": "Fiat",
"slug": "/annunci/fiat-grande-panda-1-2-hybrid-100cv-benzina-nero-fe5e7300-1f6d-49cd-992f-bdbeec314f32",
"year": "01-2026",
"model": "Grande Panda",
"price": "14900",
"dealer": "Nuova AutoAlpina Torino",
"images": [
"https://prod.pictures.autoscout24.net/listing-images/fe5e7300.jpg/250x188.webp"
],
"is_new": false,
"mileage": "10 km",
"variant": "Panda Grande Panda",
"location": {
"zip": "10155",
"city": "Torino-TO",
"countryCode": "IT"
},
"transmission": "Automatico",
"details_summary": [
{
"data": "10 km",
"iconName": "mileage_odometer"
}
]
}
],
"total_pages": 200,
"current_page": 1,
"total_results": 43631
},
"status": "success"
}
}About the autoscout24.it API
This API exposes 5 endpoints covering AutoScout24 Italy's vehicle inventory and dealer directory. Use search_listings to filter cars by make, model, price, year, fuel type, body type, and condition, then retrieve full vehicle specs, pricing breakdowns, seller contact details, and geolocation data via get_listing_detail. Make and model IDs needed for filters are resolved through dedicated lookup endpoints.
Search and Filter Listings
The search_listings endpoint accepts up to eight filter parameters — make, model, price_to, year_to, body_type, condition, sort, and page — and returns paginated results across up to 200 pages. Each result object includes the listing id, slug, make, model, variant, price, mileage, year, fuel, transmission, location, and thumbnail images. The total_results and total_pages fields let you implement pagination without guessing. Make and model values are numeric IDs, not free-text strings: use get_makes_list and get_models_by_make to resolve them before filtering.
Listing Detail and Vehicle Specs
get_listing_detail accepts a slug from any search_listings result and returns a complete listing record. The vehicle object carries full specs: make, model, variant, year, power output, fuel type, transmission, body type, and equipment list. The prices object distinguishes public and dealer pricing. seller includes dealer contact phones and links; ratings carries dealer scores specific to the listing. The location object provides latitude, longitude, city, zip, and street — useful for distance-based filtering in your own application. Note that slugs expire when listings are removed; those return an input_not_found error.
Makes, Models, and Dealer Profiles
get_makes_list returns every brand on the platform as an array of {label, value} pairs where value is the numeric make ID. get_models_by_make accepts either a numeric make_id or a case-sensitive make_name and returns models as {label, value, makeId} objects. These two endpoints are the canonical source for filter IDs used in search_listings.
get_dealer_profile retrieves a single dealer by bare slug (no path prefix). The response includes customerName, customerAddress, customerPhoneNumbers, openingHours by department, aboutUs text, and a ratings object with reviewCount, ratingAverage, ratingStars, and recommendPercentage. Dealer slugs appear in listing detail responses via the seller field.
- Aggregate Italian used-car inventory by make and model for a price-comparison tool
- Build a dealer locator using latitude/longitude and customerAddress from listing and dealer endpoints
- Track price trends for specific vehicle variants using search_listings with year_to and price_to filters
- Enrich a CRM with dealer contact info and ratings pulled from get_dealer_profile
- Populate a vehicle catalogue with body type, fuel, transmission, and power specs from get_listing_detail
- Generate make/model dropdown menus for a car-search UI using get_makes_list and get_models_by_make
- Monitor new listings for a specific make and condition by polling search_listings with condition='N'
| 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.