# Eurostat Economic Data — EU GDP, Inflation, Unemployment (`gochujang/eurostat-economic-data`) Actor

Fetch official Eurostat EU/Euro Area economic indicators: GDP growth, HICP inflation (headline + core), unemployment, industrial production, retail sales, sentiment indices, government debt/deficit, house prices, employment. Free, no API key required.

- **URL**: https://apify.com/gochujang/eurostat-economic-data.md
- **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 eurostat indicator fetcheds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Eurostat Economic Data — EU GDP, Inflation, Unemployment, Industry

Fetch official Eurostat EU and Euro Area economic indicators directly from the European Commission's free data API. Covers GDP growth, HICP inflation (headline and core), unemployment, industrial production, retail sales, sentiment indices, government debt and deficit, house prices, and more. No API key required.

### What It Does

- Fetches 17 pre-configured EU/Euro Area economic time series from Eurostat
- Concurrent fetching — all selected indicators retrieved in parallel
- Returns standardized records: indicator, country, date, value, unit
- Configurable time range (default: from 2010)
- Gracefully skips unavailable indicators with a warning (never fails hard)

### Available Indicators

| Key | Name | Frequency |
|-----|------|-----------|
| `gdp_growth_qoq` | GDP Growth QoQ (Euro Area) | Quarterly |
| `gdp_growth_yoy` | GDP Growth YoY (Euro Area) | Quarterly |
| `unemployment_rate` | Unemployment Rate (Euro Area) | Monthly |
| `hicp_headline` | HICP Headline Inflation YoY (Euro Area) | Monthly |
| `hicp_core` | HICP Core Inflation ex. Food & Energy YoY | Monthly |
| `industrial_production` | Industrial Production Index (Euro Area) | Monthly |
| `retail_sales` | Retail Trade Volume Index (Euro Area) | Monthly |
| `economic_sentiment` | Economic Sentiment Indicator (EU) | Monthly |
| `consumer_confidence` | Consumer Confidence Indicator (EU) | Monthly |
| `manufacturing_confidence` | Manufacturing Confidence (EU) | Monthly |
| `services_confidence` | Services Confidence Indicator (EU) | Monthly |
| `government_debt` | Government Gross Debt % GDP (Euro Area) | Annual |
| `government_deficit` | Government Net Lending/Deficit % GDP | Annual |
| `house_price_index` | House Price Index (EU27) | Quarterly |
| `construction_output` | Construction Output Index (Euro Area) | Monthly |
| `employment_rate` | Employment Rate 20-64 (Euro Area) | Quarterly |
| `trade_balance_extra_eu` | EU27 Extra-Trade Balance (EUR million) | Monthly |

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `indicators` | array | 11 key indicators | List of indicator keys to fetch |
| `since` | string | `"2010-01"` | Start period: `"2010-01"` (monthly), `"2010-Q1"` (quarterly), `"2010"` (annual) |

### Sample Output

```json
[
  {
    "indicator": "gdp_growth_qoq",
    "indicator_name": "GDP Growth QoQ (Euro Area, quarterly)",
    "country": "EA20",
    "date": "2025-Q1",
    "value": 0.4,
    "unit": "% change on previous quarter"
  },
  {
    "indicator": "hicp_headline",
    "indicator_name": "HICP Headline Inflation YoY (Euro Area, monthly)",
    "country": "EA20",
    "date": "2025-05",
    "value": 2.0,
    "unit": "Annual rate of change (%)"
  },
  {
    "indicator": "unemployment_rate",
    "indicator_name": "Unemployment Rate (Euro Area, monthly)",
    "country": "EA20",
    "date": "2025-05",
    "value": 6.2,
    "unit": "% of active population"
  },
  {
    "indicator": "economic_sentiment",
    "indicator_name": "Economic Sentiment Indicator (EU, monthly)",
    "country": "EU",
    "date": "2025-05",
    "value": 97.8,
    "unit": "Index (long-run avg = 100)"
  }
]
```

### Use Cases

**EUR/USD macro analysis** — Combine GDP growth, HICP inflation, and unemployment trends to assess ECB policy trajectory and EUR directional bias.

**EU cycle tracking** — Monitor industrial production, retail sales, and sentiment to identify early expansion or contraction in the Euro Area business cycle.

**Government debt monitoring** — Track debt-to-GDP and deficit ratios across annual fiscal updates for sovereign credit analysis.

**Housing market research** — Use the quarterly House Price Index across EU27 for real estate trend analysis.

**Sentiment dashboards** — Build composite EU sentiment feeds using Economic, Consumer, Manufacturing, and Services confidence in a single pipeline.

**Academic and backtesting** — Pull data back to 2010 (or earlier with `since` parameter) for long-horizon regression models and strategy backtests.

### Pricing

- **$0.002 per indicator fetched** (PPE — Pay Per Event)
- Default run (11 indicators) ≈ $0.022

### FAQ

**Do I need an API key?**
No. Eurostat's JSON API is free and open — no registration required.

**How current is the data?**
Eurostat typically publishes with a 1–2 month lag (e.g., May unemployment data published in July). Data reflects the latest available release.

**Can I fetch specific countries (Germany, France, etc.)?**
The built-in indicators cover Euro Area (EA20) and EU aggregates. For country-level data, you can modify the catalog by adding custom entries — see the `geo` parameter (DE = Germany, FR = France, IT = Italy, ES = Spain, etc.).

**What's the difference between GDP QoQ and YoY?**
`gdp_growth_qoq` is the sequential quarter-on-quarter change (annualized by ECB, published seasonally adjusted). `gdp_growth_yoy` compares to the same quarter in the prior year — less volatile, better for trend analysis.

**What is HICP core?**
HICP excluding energy, food, alcohol, and tobacco. The ECB focuses on core inflation for its 2% target assessment.

### Data Source

Official [Eurostat](https://ec.europa.eu/eurostat) dissemination API — European Commission, free for public use.

***

### Related actors

- [ECB Economic Data Tracker](https://apify.com/gochujang/ecb-economic-data) — ECB rates, EURIBOR, and M3 money supply to pair with Eurostat's real economy data
- [OECD Stats Tracker](https://apify.com/gochujang/oecd-stats-tracker) — OECD comparative data for EU benchmarking against the US, Japan, and other members
- [World Bank Data Scraper](https://apify.com/gochujang/world-bank-data) — Global development indicators to add non-EU context to Eurostat EU analysis

### Feedback

If this actor powers your European economic research, a review helps others find it: [Leave a review on Apify Store](https://apify.com/gochujang/eurostat-economic-data#reviews)

***

**Keywords:** Eurostat data, EU economic indicators, Euro Area GDP, HICP inflation, EU unemployment, industrial production, Eurostat API, EU statistics, European economy, retail sales EU, government debt EU, EU house prices, economic data scraper

# Actor input Schema

## `indicators` (type: `array`):

Indicator keys. Available: gdp_growth_qoq, gdp_growth_yoy, unemployment_rate, hicp_headline, hicp_core, industrial_production, retail_sales, economic_sentiment, consumer_confidence, manufacturing_confidence, services_confidence, government_debt, government_deficit, house_price_index, construction_output, employment_rate, trade_balance_extra_eu.

## `since` (type: `string`):

Start date in Eurostat format: '2010-01' (monthly), '2010-Q1' (quarterly), '2010' (annual).

## Actor input object example

```json
{
  "indicators": [
    "gdp_growth_qoq",
    "gdp_growth_yoy",
    "unemployment_rate",
    "hicp_headline",
    "hicp_core",
    "industrial_production",
    "retail_sales",
    "economic_sentiment",
    "consumer_confidence",
    "government_debt",
    "house_price_index"
  ],
  "since": "2010-01"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("gochujang/eurostat-economic-data").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("gochujang/eurostat-economic-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call gochujang/eurostat-economic-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gochujang/eurostat-economic-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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