hyundai.com APIwww.hyundai.com ↗
Retrieve Hyundai vehicle trims, powertrains, color options, and pricing, plus generate 360° CDN image URLs for any configuration via two structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/6d9e27b6-e96d-4b1b-884a-23ce6f7ec186/get_configurations' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all available configurations for a Hyundai model, including trims, powertrains, packages, exterior/interior colors, and prices. Returns FSC codes, color codes, and interior color codes needed for the get_image_urls endpoint. Currently only the German market (country 'de') is supported by the upstream API.
| Param | Type | Description |
|---|---|---|
| country | string | Country code. Only 'de' (Germany) is confirmed working; other country codes are rejected by the upstream API. |
| language | string | Language code. Only 'de' is confirmed working. |
| model_id | string | Model name or raw model ID. Confirmed working: 'bayon'. Other names accepted but may return no data depending on upstream availability: 'i10', 'i20', 'i30', 'kona', 'tucson', 'ioniq5', 'ioniq6', 'santa-fe'. Raw model IDs like 'SW|W5||' are also accepted. |
{
"type": "object",
"fields": {
"country": "string - country code used",
"model_id": "string - resolved internal model ID",
"configurations": "array of configuration objects with fsc, trim_name, powertrain, price, exterior_colors, packages",
"total_configurations": "integer - number of configurations returned"
},
"sample": {
"data": {
"country": "de",
"model_id": "SW|W5||",
"configurations": [
{
"fsc": "SWW5K5G17CC440",
"price": 23900,
"trim_id": "TR0007",
"packages": [],
"body_type": "Wagon 5 DR",
"eco_label": "D",
"net_price": 20084.03,
"trim_name": "Select",
"model_name": "i20/BAYON",
"powertrain": "1.0 T-GDI (90 PS) 6-M/T Frontantrieb",
"discount_price": 0,
"exterior_colors": [
{
"code": "A7G",
"name": "Aurora Grey",
"type": "Metallic",
"price": 650,
"chip_image": "https://www.hyundai.com/eu/dam/hpp/eu/model/bc3_cuv/Exterior/colorchip_ext/A7G_AuroraGrey_Pearl.jpg",
"interior_colors": [
{
"code": "NNB",
"name": "Stoff Schwarz mit Innenraum Schwarz",
"chip_image": "https://www.hyundai.com/eu/dam/hpp/hmd/modelle/bc3_cuv_bayon_fl/polster/BC3_CUV_NNB-Cloth_BlackMonoGLSTop.jpg"
}
]
}
]
}
],
"total_configurations": 17
},
"status": "success"
}
}About the hyundai.com API
The Hyundai.com API provides 2 endpoints to query car configuration data and generate visualization assets from Hyundai's vehicle configurator. The get_configurations endpoint returns all available trims, powertrain options, exterior and interior colors, package codes, and pricing for a given model, while get_image_urls produces up to 36 angle-specific CDN image URLs for any valid FSC, exterior color, and interior color combination.
Vehicle Configuration Data
The get_configurations endpoint accepts a model_id (e.g. 'bayon'), along with optional country and language parameters. Currently, only the German market (country: 'de', language: 'de') is confirmed to return data. The response includes an array of configuration objects, each containing an fsc (Full Specification Code), trim_name, powertrain, price, packages, and nested exterior_colors and interior_colors arrays with their respective color codes. The total_configurations field gives the count of distinct configurations returned.
360° Image URL Generation
The get_image_urls endpoint takes a required fsc, ext_color, and int_color — all sourced directly from get_configurations output — plus optional width, height, country (uppercase, e.g. 'DE'), and frames parameters. The frames input accepts a comma-separated list of frame numbers between 1 and 36; omitting it returns all 36 angles at 10-degree increments. Each entry in the images array includes a frame integer, angle_degrees integer, and a url string pointing to the CDN-hosted render. The resolution field in the response confirms the WxH format used.
Scope and Limitations
Market coverage is currently limited to Germany (de). Other country codes are rejected. Model support is confirmed for 'bayon'; other model identifiers may be accepted but can return empty configurations depending on availability. The two endpoints are designed to be used in sequence: retrieve valid codes from get_configurations, then pass them directly to get_image_urls to construct image URLs without any guesswork on code formats.
- Build a Hyundai vehicle comparison tool showing trim-level pricing differences for the German market
- Populate a car configurator UI with exterior and interior color swatches from
exterior_colorsandinterior_colorsdata - Generate and cache 360° spin assets for a specific FSC and color combination using
get_image_urls - Extract powertrain options across trims to filter models by engine type in a vehicle search tool
- Automate retrieval of FSC codes and color codes to batch-generate preview thumbnails for all configurations
- Display up-to-date package options and prices for a specific Hyundai trim in a dealership web application
| 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 Hyundai offer an official public developer API?+
What does `get_configurations` return beyond just trim names?+
fsc (Full Specification Code), trim_name, powertrain, price, packages, and arrays of exterior_colors and interior_colors with their codes. These codes are the required inputs for the get_image_urls endpoint.Is data available for markets outside Germany?+
country: 'de') is confirmed working. Other country codes are rejected. The API covers trims, colors, and pricing for the de locale. You can fork it on Parse and revise it to add support for additional market endpoints if Hyundai exposes them.Can I retrieve used-car listings or dealer inventory through this API?+
What happens if I pass a model_id other than 'bayon'?+
de market or the identifier does not resolve to a known internal model ID. Always check the total_configurations field in the response to confirm data was returned.