Hyundai Europe Configurator Scraper

Extract complete new-car catalog data from Hyundai Europe's official online configurator — trims, powertrains, prices with explicit currency, colors, and packages — for 15 European markets in a single run.

🎁 Try it free — your first $5 of usage is on Apify. No credit card required.

🚗 What is Hyundai Europe Configurator Scraper?

Hyundai Europe Configurator Scraper is a data extraction tool that collects the full new-car catalog from Hyundai's official European websites. It automatically discovers every model available in each country and returns structured, flat data ready for analysis — one row per trim/powertrain combination.

Use Hyundai Europe Configurator Scraper to:

• 💶 Monitor pricing across markets — compare retail prices (incl. and excl. tax), discounts, and promotions for every Hyundai model, with the currency stated on every row
• 📋 Track product availability — see which trims, powertrains, and color options are offered in each market
• ⚡ Analyze powertrain strategy — compare engine lineups, fuel types, and eco labels by country
• 🔄 Automate recurring catalog snapshots — schedule daily or weekly runs and diff them by scrapedAt

The Apify platform gives Hyundai Europe Configurator Scraper scheduling, monitoring, API access, proxy rotation, and integrations with Make, Zapier, Google Sheets, and more — all out of the box.

📊 What data does Hyundai Europe Configurator Scraper extract?

Hyundai Europe Configurator Scraper returns one row per FSC (Full Specification Code) — each unique trim/powertrain combination available in the configurator:

🌍 Country, language & currency	🚙 Model name & body type
🏷️ Trim name & level	⚙️ Powertrain & fuel type
💶 Retail price (incl. & excl. tax)	🎯 Discounts & promotions
🎨 Exterior & interior colors with prices	📦 Optional packages with prices
🔧 Engine specs (HP, kW, displacement)	🌱 Eco/emissions label
🔢 FSC & internal codes	🕒 Extraction timestamp

Field reference

Field	Type	Description
country	string	Market code, ISO 3166-1 alpha-2 (ES, DE, GB, …)
language	string	Language of the market site (es, de, en, …)
modelId	string	Configurator model identifier
fsc	string	Full Specification Code — unique per market + model
internalCode	string | null	Hyundai internal code
modelCd / modelNm	string	Model code / commercial model name (TUCSON, IONIQ 5, KONA…)
bodytype / bodytypeNm	string | null	Body code / body type name
trimId / trimNm / trimSort	string / string / integer	Trim identifier, name (KLASS, N Line…) and display order
powertrainId / powertrainNm	string	Powertrain identifier and description
powertrainNmEngine	string | null	Engine description
fuelTypeNm	string | null	Fuel type, in the market language
displacement	number | null	Engine displacement (cc)
petMaxPowerHp / petMaxPowerKw	number | null	Maximum power (HP / kW)
fscPrice	number | null	Recommended retail price including taxes (see Market notes below for TR)
fscPrice2	number | null	Price excluding taxes (see Market notes below for TR)
currency	string	ISO 4217 code of all price fields in the row (EUR, GBP, CHF, CZK, NOK, PLN, SEK, TRY)
discount1Price … discount3Price	number | null	Promotional discounts (meaning varies by market, see Market notes below)
tradeinPrice	number | null	Trade-in bonus (meaning varies by market, see Market notes below)
enginePrice / transmissionPrice	number | null	Engine / transmission surcharges
ecoLabel	string | null	Environmental label where applicable (e.g. ES: ZERO, ECO, C, B)
colors	JSON string | null	Exterior/interior color combinations with prices
packages	JSON string | null	Optional packages with names and prices
numExtColors / numPackages	integer	Number of exterior colors / packages
scrapedAt	string	UTC timestamp (ISO 8601) when the row was extracted

💡 All prices in a row share the same currency. Fields other than country, language, modelId and currency may be null depending on market data availability.

Price-level fields

These fields are added to every row to make prices comparable across markets. They never replace the fields above: fscPrice, fscPrice2, discount1Price … tradeinPrice keep the values published by the source.

Field	Type	Description
priceTariff	number | null	List price before any brand discount (fscPrice). null if the row has no price
priceOffer	number | null	Final brand price: priceTariff minus the brand discount of the market. Equals priceTariff when there is no discount. Public incentives identified by the actor are never subtracted (see ES in Market notes)
priceDiscount	number | null	priceTariff − priceOffer (0 if no discount; null if no price)
priceTariffAvailable	boolean	false if the row has no list price
priceLevel	string	Level of fscPrice: list, or base_ex_all_taxes (TR)
priceVatBasis	string	Fiscal basis of priceTariff / priceOffer: gross (VAT included) or excl_vat_and_otv (TR)
pricePublicIncentive	number | null	Public incentive linked to the version when it can be identified (e.g. UK Electric Car Grant)
publicIncentiveIn	string | null	none = informed only, not subtracted from any price field. null if there is no incentive
offerCondition	string | null	Condition of the brand discount (brand_financing, unknown, …). null if priceDiscount is 0
offerValidUntil / offerFrom / offerUpTo	null	Reserved. This source does not publish offer dates or model-level offers
priceComponents	null	Reserved. This source does not publish a price breakdown
includesRegistrationTax	string	yes, no, n.a. (no such tax in the market) or unknown. Set per market
includesDelivery	string	yes, no or unknown. Set per market
hidden	boolean	Always false for this source
priceFlags	string[]	Quality notes: tariff_not_published, legacy_base_ex_taxes, incentive_amount_unverified, variant_id_hashed, variant_key_collision. Empty = none
variantKey	string	Unique key of the version within a country and run: fsc|modelId (an h: hash if the FSC is missing; a repeated key gets a ~2, ~3 suffix that follows API order and may change between runs)
discoverySource	string	How the model was found: sitemap, listing (configurator listing page) or union (known-model check). The sitemap of some markets omits models that are on sale; those are added from the listing page or the known-model check, without repeating versions already captured

Market notes: what the legacy discount and price fields represent

Market	Note
GB	On electric versions, a discount1Price, discount2Price, discount3Price or tradeinPrice of 1,500 or 3,750 GBP corresponds to the public Electric Car Grant. It is reported in pricePublicIncentive (publicIncentiveIn = none) and excluded from priceOffer / priceDiscount
BE, LU	The "from" price on the website subtracts both discount1Price and discount3Price; priceOffer does the same. offerCondition is unknown
NL	tradeinPrice repeats discount1Price. It is not added again: priceDiscount uses discount1Price only
ES	priceOffer subtracts discount1Price and offerCondition is brand_financing. On electric versions the amount may include a public incentive, so the row is flagged incentive_amount_unverified and pricePublicIncentive is null
TR	fscPrice is the tax base, without special consumption tax (ÖTV) or VAT (KDV); it is not the consumer price. fscPrice2 is derived from it and is not a net price. priceLevel = base_ex_all_taxes, priceVatBasis = excl_vat_and_otv, flag legacy_base_ex_taxes
Other markets	priceOffer = fscPrice − discount1Price; priceLevel = list, priceVatBasis = gross

Electric versions are identified from the fuel type label returned by the source in each market language.

🛠️ How to use Hyundai Europe Configurator Scraper

Getting Hyundai catalog data takes under a minute:

1. Create a free Apify account at apify.com — your first $5 is free
2. Open Hyundai Europe Configurator Scraper in Apify Console or click Try for free on this page
3. Select your markets — pick one or more of the 15 markets with data (see table below)
4. Set a model limit (optional) — use 2–3 models per country for a quick test
5. Click Start and wait ~30 seconds per country
6. Download your results in JSON, CSV, Excel, or XML — or access them via API

Example: scrape Spain and Germany

{
  "countries": ["es", "de"],
  "maxModelsPerCountry": 0,
  "debugMode": false
}

⌨️ Input parameters

Parameter	Type	Required	Default	Description
countries	array	No	All 28	Markets to scrape (multiselect). Only the 15 markets below return data
maxModelsPerCountry	integer	No	0 (unlimited)	Limit models per country (for testing)
proxyConfiguration	object	No	Apify proxy	Proxy settings — datacenter works fine
debugMode	boolean	No	false	Verbose logging for troubleshooting

📤 Output example

Each result is a structured JSON object. Sample from a real run (Spain):

{
  "country": "ES",
  "language": "es",
  "modelId": "GT|W5||G",
  "fsc": "GTW51JC57DD4C9",
  "modelNm": "TUCSON",
  "bodytypeNm": "Wagon 5 DR",
  "trimNm": "KLASS",
  "powertrainNm": "1.6 CRDi 136CV Híbrido",
  "fuelTypeNm": "Híbrido",
  "displacement": 1598,
  "petMaxPowerHp": 136,
  "petMaxPowerKw": 100,
  "fscPrice": 39425,
  "fscPrice2": 32582.64,
  "currency": "EUR",
  "discount1Price": 10800,
  "ecoLabel": "ECO",
  "colors": "[{\"extColorCd\":\"A2B\",\"extColorNm\":\"ABYSS BLACK\",\"extColorPrice\":600,...}]",
  "packages": null,
  "numExtColors": 10,
  "numPackages": 0,
  "scrapedAt": "2026-10-01T14:05:12+00:00"
}

🌍 Supported markets

Code	Market	Currency	Typical rows
BE	Belgium	EUR	~200
CH	Switzerland	CHF	~160
CZ	Czech Republic	CZK	~700
DE	Germany	EUR	~750
ES	Spain	EUR	~175
FR	France	EUR	~140
GB	United Kingdom	GBP	~145
IT	Italy	EUR	~280
LU	Luxembourg	EUR	~230
NL	Netherlands	EUR	~250
NO	Norway	NOK	~90
PL	Poland	PLN	~350
SE	Sweden	SEK	~260
SK	Slovakia	EUR	~750
TR	Turkey	TRY	~35

Row counts change as Hyundai adds or retires models. A full run of the 15 markets returns ~4,500 rows.

Markets without data: AT, PT, DK, FI, IE, HR, RO, BG, HU, SI, EE, LV, LT remain selectable in the input but currently return 0 rows — Hyundai does not serve them through its central European configurator.

💰 How much does it cost to use Hyundai Europe Configurator Scraper?

Hyundai Europe Configurator Scraper runs on Apify's standard Compute Unit (CU) pricing. It uses plain HTTP requests (no browser), so runs are light.

Scope	Time	Approx. cost
1 country (~20 models)	~30 seconds	< $0.01
All 15 markets with data	~10 minutes	~$0.05–0.10

💡 Is it free? Your first $5 of usage is covered by Apify's free plan — enough for dozens of full-catalog runs.

🧰 Troubleshooting

0 rows for a market

• Check the market is one of the 15 listed under Supported markets. The 13 markets without data always return 0 rows; this is expected, not an error.
• If a supported market suddenly returns 0 rows, Hyundai may be updating that site. Retry later and report it in the Issues tab with the run ID.

Prices are 0 or null

• Some models are "request a quote" in certain markets — fscPrice can be null.
• fscPrice2 (excl. tax) can be null if the market does not publish it.

Comparing prices across markets

• Always use currency — prices are in local currency (e.g. CZ in CZK, SE in SEK). Convert before comparing.

Run timeout

• The default timeout is enough for all 15 markets. If you filter to a few markets, a 600 s timeout is plenty.
• Leaving countries empty also visits the 13 markets without data, which adds a little run time — select the 15 supported markets to avoid it.

🔗 Related Rastriq Actors

Explore the full Rastriq intelligence portfolio on Apify Store:

Actor	Description
AutoScout24 Scraper	Extract car listings from Europe's largest car marketplace
Mobile.de Scraper	Scrape Germany's #1 car marketplace
Coches.net Scraper	Extract Spanish car classifieds
Collecting Cars Scraper	Online car auction data
Automobile Catalog Scraper	OEM car specifications database

❓ Frequently Asked Questions

Is scraping Hyundai's configurator legal?

Hyundai Europe Configurator Scraper only accesses publicly available data on Hyundai's official websites — information visible to any visitor without logging in. We respect rate limiting and apply conservative request pacing to avoid overloading their servers.

As with any data collection activity, you are responsible for ensuring your use case complies with applicable laws (GDPR, CCPA) and Hyundai's Terms of Service. For guidance, see Apify's blog on the legality of web scraping.

Does Hyundai Europe Configurator Scraper require a Hyundai account or API key?

No. The scraper works entirely with public data and does not require any account, login, or API credentials.

How often should I run it?

Hyundai updates its configurator when new models launch, trims change, or promotional pricing is updated. A weekly schedule captures most changes; for price monitoring during campaign periods, daily runs are recommended.

What proxy configuration should I use?

Datacenter proxies (the default) work well for all supported markets. If you experience issues with a specific country, switch to residential proxies in the Advanced settings.

I found a bug or my run failed. Where do I report it?

Please open an issue in the Issues tab on this page. Include your input configuration and the run ID so we can investigate quickly.

---

🇪🇸 Versión en español

Esta sección es un resumen en español del README anterior.

¿Qué es Hyundai Europe Configurator Scraper?

Hyundai Europe Configurator Scraper extrae el catálogo completo de coches nuevos del configurador oficial de Hyundai Europa. Descubre automáticamente todos los modelos disponibles en cada país y devuelve datos estructurados listos para análisis: acabados, motorizaciones, precios con su moneda, colores, paquetes opcionales y etiquetas medioambientales.

¿Qué datos extrae?

Campo	Descripción
modelNm	Nombre del modelo (TUCSON, IONIQ 5, KONA…)
trimNm	Nivel de acabado (KLASS, TECNO, N Line…)
powertrainNm	Motorización (ej. "1.6 CRDi 136CV Híbrido")
fscPrice / fscPrice2	Precio recomendado con / sin impuestos
currency	Moneda ISO 4217 de todos los precios de la fila
discount1Price	Descuento promocional
ecoLabel	Etiqueta medioambiental (ECO, CERO, C, B)
colors / packages	Colores y paquetes opcionales con precios
scrapedAt	Fecha y hora UTC de extracción

¿Cómo usarlo?

1. Crea una cuenta gratuita en apify.com
2. Abre el actor y selecciona los países (15 mercados con datos: ES, DE, FR, IT, GB, NL, NO, PL, SE, TR, BE, CZ, SK, CH, LU)
3. Haz clic en Start — tarda ~30 segundos por país
4. Descarga los resultados en JSON, CSV o Excel

¿Cuánto cuesta?

El coste es prácticamente cero: un run completo de los 15 mercados con datos consume ~0,05–0,10 $ en CUs. Los primeros 5 $ de uso son gratis con el plan gratuito de Apify.