coches.net APIcoches.net ↗
Search Spanish used car listings, get vehicle details, technical specs, and market price analysis from coches.net via a structured REST API.
curl -X POST 'https://api.parse.bot/scraper/a99c8bfd-efd4-4a37-ad34-53a2aadec5d1/search_vehicles' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "1",
"size": "5",
"query": "BMW",
"fuelTypeIds": "1",
"provinceIds": "28",
"category1Ids": "2500",
"sellerTypeId": "2"
}'Search for vehicles on coches.net with various filters and pagination. Returns paginated results including items, paid/promoted items, total counts, and aggregation data for further filtering.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| size | integer | Number of results per page. |
| hp_to | integer | Maximum horsepower. |
| km_to | integer | Maximum mileage in km. |
| query | string | Search keyword (e.g. 'BMW', 'Audi A4'). |
| makeId | integer | ID of the car make (from get_makes_and_models). |
| hp_from | integer | Minimum horsepower. |
| km_from | integer | Minimum mileage in km. |
| modelId | integer | ID of the car model (from get_makes_and_models). Requires makeId. |
| year_to | integer | Maximum year of manufacture. |
| price_to | integer | Maximum price in euros. |
| sort_term | string | Sort field: relevance, price, km, year. |
| year_from | integer | Minimum year of manufacture. |
| contractId | string | Seller contract ID for filtering by a specific dealer. |
| price_from | integer | Minimum price in euros. |
| sort_order | string | Sort order: asc or desc. |
| bodyTypeIds | string | Comma-separated body type IDs. |
| fuelTypeIds | string | Comma-separated fuel type IDs (1: Diesel, 2: Gasoline, 3: Electric, 4: Hybrid). |
| provinceIds | string | Comma-separated province IDs (e.g. '28' for Madrid). |
| category1Ids | string | Comma-separated category IDs: 2500 (Used), 2501 (KM0), 2502 (New). |
| sellerTypeId | string | Seller type as a single value: 1 for Private, 2 for Professional. |
| transmissionTypeId | string | Comma-separated transmission type IDs (1: Manual, 2: Automatic). |
| environmentalLabelIds | string | Comma-separated environmental label IDs. |
{
"type": "object",
"fields": {
"items": "array of vehicle listing objects",
"paidItems": "array of promoted vehicle listing objects",
"totalPages": "integer total number of pages",
"aggregations": "array of filter aggregation counts",
"totalResults": "integer total number of matching vehicles"
},
"sample": {
"data": {
"items": [
{
"hp": 122,
"id": "70620056",
"km": 193000,
"make": "AUDI",
"year": 2017,
"model": "A4",
"price": {
"amount": 15000
},
"title": "AUDI A4 2.0 TDI design edition",
"fuelType": "Diésel"
}
],
"paidItems": [],
"totalPages": 1870,
"aggregations": [
{
"name": "make",
"items": [
{
"key": "1",
"totalResults": 71
}
]
}
],
"totalResults": 9350
},
"status": "success"
}
}About the coches.net API
The coches.net API exposes 5 endpoints covering vehicle search, full listing details, make/model lookups, technical specifications, and market price analysis from Spain's major used-car marketplace. The search_vehicles endpoint supports filtering by horsepower, mileage, make ID, and keyword, returning paginated results with promoted listings and aggregation counts for building faceted search interfaces.
Search and Discovery
The search_vehicles endpoint accepts POST requests with filters including makeId (sourced from get_makes_and_models), hp_from/hp_to, km_from/km_to, a freetext query, and page/size for pagination. The response surfaces both items (organic listings) and paidItems (promoted listings) as separate arrays, alongside totalResults, totalPages, and an aggregations array that carries filter-level counts — useful for building dynamic sidebar filters without issuing additional queries.
Listing Details and Seller Data
get_vehicle_detail takes a vehicle_id from search results and returns a structured object with four top-level sections: ad (photos, description, price, and category), vehicleSpecs (technical specs and equipment), financingData (terms and conditions), and professionalSeller (contact info, ratings, schedule, and geolocation). The statistics field provides view counts, favorites, and contact engagement for the listing.
Technical Specifications
get_vehicle_technical_specs returns granular performance data for a listing: maxSpeed, horsePower, acceleration (0–100 km/h in seconds), consumption broken down into urban/mixed/extraUrban in L/100km, and dimensionsInMillimeters (width, height, length). It also includes vehicleStandardEquipmentGroup and vehicleOptionalEquipmentGroup arrays, which let you compare trim levels programmatically.
Price Analysis
get_price_analysis returns the listing's price in euros alongside an indicator object containing the average market price and a rank signal showing how the listing compares to the market. A financedPrice field is included when financing terms apply, and may be null otherwise. Pairing this endpoint with search_vehicles aggregations lets you build market valuation tools scoped to specific makes, models, or mileage bands.
- Build a price-alert tool that monitors coches.net listings and flags when a vehicle's price drops below the market average returned by
get_price_analysis. - Aggregate fuel consumption data across models using
get_vehicle_technical_specsto compare urban vs. extraUrban consumption by make. - Populate a dealer inventory feed by paginating
search_vehiclesresults filtered bymakeIdand mileage range. - Build a make/model dropdown selector for a car search UI using the hierarchical data from
get_makes_and_models. - Display seller ratings and location data from
professionalSelleron a map-based dealership directory. - Track listing engagement trends by storing
statisticsfields (views, favorites, contacts) over time for the samevehicle_id. - Compute trim-level comparisons by diffing
vehicleStandardEquipmentGroupandvehicleOptionalEquipmentGrouparrays across two listings.
| 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 coches.net offer an official developer API?+
What does `search_vehicles` return beyond a list of cars?+
items (organic results) and paidItems (promoted listings) as separate arrays, plus an aggregations array with per-filter counts and totalResults/totalPages integers. This means you can build faceted filtering UIs without issuing separate count queries.Can I filter search results by model, fuel type, or body style?+
search_vehicles supports filtering by makeId, keyword query, horsepower range (hp_from/hp_to), and mileage range (km_from/km_to). Model ID, fuel type, body style, and year filters are not exposed as parameters at this time. You can fork this API on Parse and revise it to add those filter parameters.Is price analysis available for every listing?+
get_price_analysis returns a price and an indicator object (average market price and rank) for a given vehicle_id. The financedPrice field may be null when no financing data is available for the listing. Market comparison data depends on sufficient comparable listings existing in the platform's index.