cupraofficial.de APIwww.cupraofficial.de ↗
Access CUPRA's vehicle configurator data: models, trims, engines, colors, wheels, upholstery, pricing, and optional equipment across markets.
curl -X GET 'https://api.parse.bot/scraper/1be6782f-e846-4fb1-94f5-1f09ec036bdf/list_models' \ -H 'X-API-Key: $PARSE_API_KEY'
List all available CUPRA vehicle models with default pricing, engine types, efficiency data, and technical specifications. Returns configuration IDs needed for other endpoints.
| Param | Type | Description |
|---|---|---|
| language | string | Language code for responses. |
| market_code | string | Market code (e.g. '007' for Germany). |
{
"type": "object",
"fields": {
"total": "integer total number of models",
"models": "array of model objects with name, configuration_id, engine_name, prices, efficiency_data, technical_detail"
},
"sample": {
"data": {
"total": 7,
"models": [
{
"name": "Neuer RAVAL",
"price": 34250,
"prices": [
{
"name": "total",
"type": "default",
"value": 34250,
"formatted": "34.250,00 €"
}
],
"image_url": "https://render.seat.de/...",
"carline_key": "CARLINE-KS1B",
"engine_name": "Dynamic",
"engine_types": [
{
"fuelType": "Elektro",
"engineType": "PEV"
}
],
"efficiency_data": [
{
"standard": "wltp",
"engineType": "PEV",
"efficiencyClass": "A"
}
],
"price_formatted": "34.250,00 €",
"configuration_id": "ePl9IIpVw_Cws2OQj6efq653sKETiucdfXzAghau-ob...",
"technical_detail": {
"power": {
"kilowatts": {
"formatted": "155 kW"
},
"horsepower": {
"formatted": "211 PS"
}
},
"battery": {
"capacity": {
"formatted": "52 kWh"
}
}
}
}
]
},
"status": "success"
}
}About the cupraofficial.de API
The CUPRA Official API covers 5 endpoints that expose the full cupraofficial.de vehicle configurator, from listing all available models with default pricing and efficiency data via list_models, to retrieving trim levels, engine options, exterior colors, wheel choices, upholstery, and optional equipment packages — each with pricing and product images — for any configuration ID and market.
Models and Trims
The list_models endpoint returns every available CUPRA model alongside its configuration_id, engine_name, pricing, efficiency_data, and technical_detail. The configuration_id values returned here are the entry point for all downstream calls. Pass one to get_trims to retrieve the available trim levels for that model — each trim includes a key, name, description, base_configuration_id, and a highlights array summarizing its distinguishing features. Both endpoints accept a language code and a market_code parameter (e.g. '007' for Germany) to localize the response.
Configuration Details
get_configuration_details accepts a configuration_id — sourced from list_models, get_trims, or update_configuration — and returns the full spec for that configuration: engines (with fuelType, technicalDetail, efficiencyTestData, and prices), colors, wheels (with dimensions), and upholsteries. Every visual element includes an imageUrl. The prices array carries typed price objects with type, name, value, and formatted fields, reflecting the currently selected options.
Updating a Configuration
update_configuration is a POST endpoint that takes a current configuration_id and one or more equipment_codes (comma-separated, e.g. 'F14 2Y2Y' for a specific color). It returns a new_configuration_id representing the modified build, a valid boolean, and a conflicts object with add and remove arrays that identify any equipment incompatibilities introduced by the change. Pass the new_configuration_id back into get_configuration_details to see updated pricing and visuals.
Optional Equipment
get_optional_equipment returns the full list of add-ons available for a given configuration. Each item includes a code, name, category (covering areas like exterior accessories, safety systems, multimedia, and discount packages), description, prices, images, and a packageParts array for grouped packages. The total field at the top of the response gives the count of available items for that configuration.
- Build a CUPRA model comparison tool showing engine options, fuel types, and base pricing across all models using
list_models. - Render a trim-level selector UI with highlights and descriptions pulled from
get_trimsfor a chosen model. - Display a real-time configurator with color swatches and wheel visuals, sourcing
imageUrlandpricesfromget_configuration_details. - Detect equipment conflicts when a user selects incompatible options by parsing the
conflicts.addandconflicts.removearrays fromupdate_configuration. - Populate an optional extras catalog with categories, descriptions, and pricing from
get_optional_equipmentincluding grouped package contents viapackageParts. - Track pricing differences across CUPRA markets by calling
list_modelsandget_configuration_detailswith differentmarket_codevalues. - Export efficiency and emissions data for all CUPRA powertrains by iterating
engines[*].efficiencyTestDatafromget_configuration_details.
| 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 CUPRA offer an official public developer API for its configurator?+
What does `get_configuration_details` return beyond just pricing?+
engines (including fuelType, efficiencyTestData, and technicalDetail), colors, wheels (with dimensions), upholsteries, and images — all with imageUrl fields and individual prices objects. The prices array includes typed entries with value and formatted fields reflecting the current configuration state.How does `update_configuration` handle equipment conflicts?+
conflicts object containing add and remove arrays. If the submitted equipment_codes cannot coexist with the current configuration, conflicting items are listed there. The valid boolean indicates whether the resulting configuration is fully valid. The new_configuration_id reflects the applied changes regardless, so you can inspect the result with get_configuration_details.Does the API return dealer inventory or real-time stock availability?+
Are markets outside Germany covered?+
market_code parameter is supported on all endpoints, so other markets can be queried by passing the appropriate code. However, the available model lines, pricing, and option sets will vary by market, and not all markets may return the same depth of data. Coverage depends on what the configurator exposes for each market code.