Hyundai APIhyundai.com ↗
Retrieve Hyundai vehicle configurations—trims, powertrains, prices, and color codes—plus generate 360° CDN image URLs for any configuration combination.
What is the Hyundai API?
The Hyundai Configurator API exposes 2 endpoints covering the German Hyundai vehicle lineup, including models like Bayon, Kona, Tucson, and Ioniq5. The get_configurations endpoint returns full specification data—trim names, powertrain options, FSC codes, exterior and interior color codes, package details, and prices—for any supported model. The get_image_urls endpoint then takes those codes and returns up to 36 angle-specific CDN image URLs for a full 360° visual of any valid configuration.
curl -X GET 'https://api.parse.bot/scraper/6d9e27b6-e96d-4b1b-884a-23ce6f7ec186/get_configurations?country=de&language=de&model_id=bayon' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace hyundai-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.hyundai_car_configurator_api import HyundaiConfigurator, Configuration, Model, ModelId
# Initialize client
client = HyundaiConfigurator()
# Get all configurations for the Bayon model using the ModelId enum
model = client.models.get(model_id=ModelId.BAYON)
print(model.model_id, model.country, model.total_configurations)
# Iterate over configurations
for config in model.configurations:
print(config.fsc, config.trim_name, config.powertrain, config.price)
for ext_color in config.exterior_colors:
print(ext_color.code, ext_color.name, ext_color.type, ext_color.price)
for int_color in ext_color.interior_colors:
print(int_color.code, int_color.name)
# Generate 360 degree image URLs for a specific configuration
first_config = model.configurations[0]
first_ext = first_config.exterior_colors[0]
first_int = first_ext.interior_colors[0]
image_set = first_config.images(ext_color=first_ext.code, int_color=first_int.code, frames="1,10,19,28")
print(image_set.fsc, image_set.resolution, image_set.total_images)
for img in image_set.images:
print(img.frame, img.angle_degrees, img.url)
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. |
| language | string | Language code. Only 'de' is confirmed working. |
| model_id | string | Model name or raw model ID. Confirmed working values: 'bayon', '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 API
Configuration Data
The get_configurations endpoint accepts a model_id (e.g. 'bayon', 'i10', 'tucson', 'ioniq5'), a country code, and a language code. It returns an array of configuration objects, each containing an fsc (Full Specification Code), trim_name, powertrain description, price, packages, and arrays of exterior_colors and interior color codes. The total_configurations integer tells you how many distinct configurations exist for that model. Currently only the German market (country: 'de') is confirmed working.
360° Image URL Generation
Once you have an fsc, an ext_color code (e.g. 'A7G' for Aurora Grey), and an int_color code (e.g. 'NNB'), pass them to get_image_urls. The endpoint returns an images array where each object includes a frame number (1–36), an angle_degrees value (in 10° increments from 0° to 350°), and a url string pointing to the CDN-hosted render. You can request a subset of frames by passing a comma-separated list via the frames parameter, and control output dimensions with width and height.
Working With Response Fields
The fsc, ext_color, and int_color values returned by get_configurations are the required inputs to get_image_urls—these are the identifiers that tie a specific trim and color combination to its visual assets. The resolution field in the image response reports the actual dimensions used in WxH format. total_images confirms how many URLs were generated, which will be fewer than 36 if you specified a frames subset.
The Hyundai API is a managed, monitored endpoint for hyundai.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hyundai.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hyundai.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a car comparison tool showing trim-level pricing across Hyundai models like the Kona and Tucson
- Populate a vehicle configurator UI with exterior and interior color options sourced from real FSC data
- Generate 360° spin image sets for product pages using angle-specific CDN URLs from get_image_urls
- Monitor price changes across trims and powertrain variants for the German Hyundai lineup
- Extract package and powertrain combinations per model for competitive automotive market analysis
- Create a static image gallery for a specific configuration by fetching all 36 frame URLs at a fixed resolution
| 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 | 100 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 developer API for configurator data?+
What does get_configurations return for each configuration object?+
configurations array includes an fsc (Full Specification Code), trim_name, powertrain, price, packages, and color data. The exterior_colors field lists available color codes and names, and interior color codes are included for use with get_image_urls.Which markets and models are supported?+
country: 'de', language: 'de') is confirmed working. Confirmed model IDs are: bayon, i10, i20, i30, kona, tucson, and ioniq5. Other country codes or model IDs may not return data. You can fork this API on Parse and revise it to add support for additional markets or models.Can I retrieve used car listings, dealer inventory, or VIN-level data through this API?+
How do frame numbers map to viewing angles in get_image_urls?+
frames value like '1,10,19,28' returns only those four angles rather than the full 36-image set.