# 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, 100.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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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 <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/VvEoCm4zk6CpNqwoj/builds/tuz4ab4g9Kwjje3b3/openapi.json