# Hyundai Europe Configurator Scraper (`rastriq/hyundai-europe-configurator`) Actor Extracts full catalog data (trims, prices, powertrains, colors, packages) from Hyundai Europe configurator across all European markets. - **URL**: https://apify.com/rastriq/hyundai-europe-configurator.md - **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Hyundai Europe Configurator Scraper Extract complete car catalog data from Hyundai Europe's online configurator — trims, powertrains, prices, colors, and packages — across all 28 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. Use Hyundai Europe Configurator Scraper to: - 📊 **Monitor pricing across markets** — compare retail prices, discounts, and promotions for every Hyundai model across 28 countries - 🔍 **Track product availability** — see which trims, powertrains, and color options are available in each market - ⚡ **Analyze powertrain strategy** — compare engine lineups, fuel types, and eco labels (ZERO, ECO, C, B) by country - 🔄 **Automate recurring catalog snapshots** — schedule daily or weekly runs to track pricing changes and new model launches The Apify platform gives Hyundai Europe Configurator Scraper superpowers: **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 | 🚗 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 | 📊 Color & package counts | #### Key output fields | Field | Type | Description | |-------|------|-------------| | `country` | string | Market code (ES, DE, FR, IT, GB, etc.) | | `modelNm` | string | Commercial model name (TUCSON, IONIQ 5, KONA, etc.) | | `trimNm` | string | Trim level (KLASS, TECNO, N Line, STYLE, etc.) | | `powertrainNm` | string | Powertrain description (e.g. "1.6 CRDi 136CV Híbrido") | | `fuelTypeNm` | string | Fuel type (Gasoline, Diesel, Hybrid, Electric) | | `fscPrice` | number | Recommended retail price including taxes | | `fscPrice2` | number | Price excluding taxes | | `discount1Price` | number | Primary promotional discount | | `ecoLabel` | string | Environmental label (ECO, ZERO, C, B) | | `colors` | JSON | Full list of exterior/interior color combinations with prices | | `packages` | JSON | Optional packages with names and prices | | `petMaxPowerHp` | number | Maximum engine power in HP | | `displacement` | number | Engine displacement in cc | > 💡 Every field except country, language, and modelId may be null depending on market data availability. ### 🚀 How to use Hyundai Europe Configurator Scraper Getting Hyundai catalog data takes under a minute: 1. **Create a free Apify account** at [apify.com](https://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 countries, or leave empty to scrape all 28 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 ```json { "countries": ["es", "de"], "maxModelsPerCountry": 0, "debugMode": false } ```` ### ⚙️ Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `countries` | array | ❌ | All 28 | European markets to scrape (multiselect) | | `maxModelsPerCountry` | integer | ❌ | `0` (unlimited) | Limit models per country (for testing) | | `proxyConfiguration` | object | ❌ | Apify proxy | Proxy settings — datacenter works fine | | `debugMode` | boolean | ❌ | `false` | Verbose logging for troubleshooting | ### 📦 Output example Each result is a structured JSON object. Here's a sample from a real run (Spain): ```json { "country": "ES", "language": "es", "modelId": "GT|W5||G", "fsc": "GTW51JC57DD4C9", "internalCode": "GT6M2M-2602-10", "modelCd": "GT", "modelNm": "TUCSON", "bodytype": "W5", "bodytypeNm": "Wagon 5 DR", "trimId": "TR0022", "trimNm": "KLASS", "trimSort": 1, "powertrainId": "GTW51JC57|1", "powertrainNm": "1.6 CRDi 136CV Híbrido", "powertrainNmEngine": "1.6 CRDI 136CV Híbrido", "fuelTypeNm": "Híbrido", "displacement": 1598, "petMaxPowerHp": 136, "petMaxPowerKw": 100, "fscPrice": 39425, "fscPrice2": 32582.64, "discount1Price": 10800, "ecoLabel": "ECO", "colors": "[{\"extColorCd\":\"A2B\",\"extColorNm\":\"ABYSS BLACK\",\"extColorPrice\":600,...}]", "packages": null, "numExtColors": 10, "numPackages": 0 } ``` Download results in **JSON, CSV, Excel, XML, or HTML** from the Output tab, or pull them programmatically using the Apify API (see the API tab for ready-to-use code snippets). ### 💰 How much does it cost to use Hyundai Europe Configurator Scraper? Hyundai Europe Configurator Scraper runs on Apify's standard **Compute Unit (CU)** pricing. A typical run extracting a single country (~20 models, ~150 FSCs) consumes approximately 0.01 CUs. | Scope | Time | Approx. cost | |-------|------|-------------| | 1 country (~20 models) | ~30 seconds | < $0.01 | | All 28 markets | ~10 minutes | ~$0.05 | > 💡 **Is it free?** Your first $5 of usage is covered by Apify's free plan — enough for hundreds of full-catalog runs at no cost. ### 🌍 Supported markets Hyundai Europe Configurator Scraper covers all 28 European markets where Hyundai operates a car configurator: 🇪🇸 Spain · 🇩🇪 Germany · 🇫🇷 France · 🇮🇹 Italy · 🇬🇧 United Kingdom · 🇳🇱 Netherlands · 🇳🇴 Norway · 🇵🇱 Poland · 🇸🇪 Sweden · 🇹🇷 Turkey · 🇧🇪 Belgium · 🇨🇿 Czech Republic · 🇸🇰 Slovakia · 🇨🇭 Switzerland · 🇱🇺 Luxembourg · 🇦🇹 Austria · 🇵🇹 Portugal · 🇩🇰 Denmark · 🇫🇮 Finland · 🇮🇪 Ireland · 🇭🇷 Croatia · 🇷🇴 Romania · 🇧🇬 Bulgaria · 🇭🇺 Hungary · 🇸🇮 Slovenia · 🇪🇪 Estonia · 🇱🇻 Latvia · 🇱🇹 Lithuania ### 🔗 Related Rastriq Actors Explore the full [Rastriq intelligence portfolio](https://apify.com/rastriq) on Apify Store: | Actor | Description | |-------|-------------| | [AutoScout24 Scraper](https://apify.com/rastriq/autoscout24-scraper) | Extract car listings from Europe's largest car marketplace | | [Mobile.de Scraper](https://apify.com/rastriq/mobile-de-scraper) | Scrape Germany's #1 car marketplace | | [Coches.net Scraper](https://apify.com/rastriq/cochesnet-spain) | Extract Spanish car classifieds | | [Collecting Cars Scraper](https://apify.com/rastriq/collecting-cars-scraper) | Online car auction data | | [Automobile Catalog Scraper](https://apify.com/rastriq/automobile-catalog-taxonomy) | 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](https://blog.apify.com/is-web-scraping-legal/). #### 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 their configurator periodically — typically 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 most markets. If you experience issues with a specific country, switch to residential proxies in the Advanced settings. #### How do I integrate it with my workflow? Hyundai Europe Configurator Scraper integrates natively with Make (Integromat), Zapier, Google Sheets, webhooks, and the Apify API. See the API tab for ready-to-use code snippets in Python, Node.js, and more. #### 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, 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` | Precio recomendado con impuestos | | `discount1Price` | Descuento promocional | | `ecoLabel` | Etiqueta medioambiental (ECO, CERO, C, B) | | `colors` | Colores exteriores/interiores con precios | | `packages` | Paquetes opcionales con precios | #### ¿Cómo usarlo? 1. Crea una cuenta gratuita en [apify.com](https://apify.com) 2. Abre el actor y selecciona los países que te interesan 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 28 mercados consume ~0.05$ en CUs. Los primeros $5 de uso son gratis con el plan gratuito de Apify. # Actor input Schema ## `countries` (type: `array`): Select one or more European markets. Leave empty to scrape all 28 markets. ## `maxModelsPerCountry` (type: `integer`): Limit how many models to extract per country. Set 0 for unlimited. Use a low value (2-3) for testing. ## `proxyConfiguration` (type: `object`): Proxies for HTTP requests. Datacenter proxies work fine for most markets. ## `debugMode` (type: `boolean`): Enable verbose logging to see every discovered model and extracted FSC. ## Actor input object example ```json { "countries": [ "es" ], "maxModelsPerCountry": 3, "proxyConfiguration": { "useApifyProxy": true }, "debugMode": false } ``` # Actor output Schema ## `results` (type: `string`): Flat dataset with one row per FSC (Full Specification Code) — each unique trim/powertrain combination available in the Hyundai Europe configurator. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "countries": [ "es" ], "maxModelsPerCountry": 3, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("rastriq/hyundai-europe-configurator").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "countries": ["es"], "maxModelsPerCountry": 3, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("rastriq/hyundai-europe-configurator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "countries": [ "es" ], "maxModelsPerCountry": 3, "proxyConfiguration": { "useApifyProxy": true } }' | apify call rastriq/hyundai-europe-configurator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rastriq/hyundai-europe-configurator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hyundai Europe Configurator Scraper", "description": "Extracts full catalog data (trims, prices, powertrains, colors, packages) from Hyundai Europe configurator across all European markets.", "version": "0.0", "x-build-id": "b6vd5ODyy4D3Fcv2R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~hyundai-europe-configurator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-hyundai-europe-configurator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/rastriq~hyundai-europe-configurator/runs": { "post": { "operationId": "runs-sync-rastriq-hyundai-europe-configurator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/rastriq~hyundai-europe-configurator/run-sync": { "post": { "operationId": "run-sync-rastriq-hyundai-europe-configurator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Select one or more European markets. Leave empty to scrape all 28 markets.", "items": { "type": "string", "enum": [ "es", "de", "fr", "it", "gb", "nl", "no", "pl", "se", "tr", "be", "cz", "sk", "ch", "lu", "at", "pt", "dk", "fi", "ie", "hr", "ro", "bg", "hu", "si", "ee", "lv", "lt" ], "enumTitles": [ "Spain", "Germany", "France", "Italy", "United Kingdom", "Netherlands", "Norway", "Poland", "Sweden", "Turkey", "Belgium", "Czech Republic", "Slovakia", "Switzerland", "Luxembourg", "Austria", "Portugal", "Denmark", "Finland", "Ireland", "Croatia", "Romania", "Bulgaria", "Hungary", "Slovenia", "Estonia", "Latvia", "Lithuania" ] } }, "maxModelsPerCountry": { "title": "Max models per country", "minimum": 0, "type": "integer", "description": "Limit how many models to extract per country. Set 0 for unlimited. Use a low value (2-3) for testing.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies for HTTP requests. Datacenter proxies work fine for most markets." }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logging to see every discovered model and extracted FSC.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```