# Eurostat EU Statistics Scraper: Unemployment, Inflation, GDP (`scrapers_lat/eurostat-eu-statistics-scraper`) Actor

Official Eurostat data as tidy rows by country and time: unemployment, HICP inflation, GDP, population and thousands more datasets across the EU-27 and EFTA. Friendly presets, raw dataset codes, dimension filters, date ranges, optional AI trend insight. JSON, CSV, Excel.

- **URL**: https://apify.com/scrapers\_lat/eurostat-eu-statistics-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools, AI, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.32 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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

[![Eurostat EU Statistics Scraper](https://scrapers.lat/banners/eurostat-eu-statistics-scraper.png)](https://apify.com/scrapers_lat/eurostat-eu-statistics-scraper)

## Eurostat EU Statistics Scraper

Get official **Eurostat** statistics as tidy, ready-to-use JSON rows: **unemployment**, **HICP inflation**, **GDP**, **population**, and **thousands more datasets** covering the **EU-27 plus EFTA**, broken down by country and time period. Friendly one-click presets, raw dataset codes and dimension filters for power users, flexible date ranges, and an optional AI trend insight.

Perfect for fintech apps, EU economic research, market analysis, dashboards, and compliance teams that need harmonized, comparable statistics across European countries.

### What you get

One clean row per observation, with the value already parsed as a number and labelled with its country, period, unit, and every other dimension present (sex, age, coicop, and so on). No JSON-stat unraveling on your side.

```json
{
  "dataset": "une_rt_m",
  "datasetLabel": "Unemployment by sex and age - monthly data",
  "geo": "ES",
  "geoLabel": "Spain",
  "time": "2026-06",
  "value": 10.1,
  "unit": "Percentage of population in the labour force",
  "unitCode": "PC_ACT",
  "observedAt": "2026-08-17T05:27:24.000Z",
  "error": null,
  "freq": "M",
  "freqLabel": "Monthly",
  "s_adj": "SA",
  "s_adjLabel": "Seasonally adjusted data, not calendar adjusted data",
  "age": "TOTAL",
  "ageLabel": "Total",
  "sex": "T",
  "sexLabel": "Total"
}
```

### Datasets (presets)

Pass a friendly alias in `dataset` and sensible default dimensions are applied for you, or pass any raw Eurostat dataset code.

| Preset | Eurostat code | What it returns | Default dimensions |
| --- | --- | --- | --- |
| `unemployment` | `une_rt_m` | Monthly unemployment rate by country | sex=T, age=TOTAL, s\_adj=SA, unit=PC\_ACT |
| `inflation` | `prc_hicp_manr` | HICP inflation, annual rate of change (monthly) | coicop=CP00, unit=RCH\_A |
| `gdp` | `namq_10_gdp` | Quarterly GDP, chain-linked volumes | na\_item=B1GQ, unit=CLV10\_MEUR, s\_adj=SCA |
| `population` | `demo_pjan` | Population on 1 January by country | sex=T, age=TOTAL |
| `gdp_growth` | `tec00115` | Real GDP growth rate, annual | (dataset defaults) |
| any raw code | e.g. `nrg_bal_c` | Any Eurostat dataset you want | set your own via `filters` |

### Input

| Field | Type | Description |
| --- | --- | --- |
| `dataset` | string | A preset alias (`unemployment`, `inflation`, `gdp`, `population`, `gdp_growth`) or any raw Eurostat dataset code (e.g. `nrg_bal_c`). Default `unemployment`. |
| `geo` | array | Country or area codes, e.g. `DE`, `FR`, `ES`, `IT`. Use `EA` for the euro area or `EU27_2020` for the EU-27 aggregate. Leave empty for every geo the dataset offers. |
| `sinceTimePeriod` | string | Earliest period, e.g. `2020`, `2024-Q1`, or `2026-01`. If since and until are both empty, the last 12 periods are returned. |
| `untilTimePeriod` | string | Latest period, e.g. `2026` or `2026-07`. Optional. |
| `filters` | object | Power-user passthrough of arbitrary dimension = value pairs, e.g. `{"unit": "PC_ACT", "sex": "T"}`. Overrides preset defaults; a value may be an array for several categories. |
| `withAiInsight` | boolean | Opt-in AI trend summary of the returned series (paid add-on, one charge per run). Disabled for free plans. |
| `maxResults` | integer | Maximum observation rows. Default 5000. Free plans capped at 10. |

### Output fields

| Field | Description |
| --- | --- |
| `dataset` | Eurostat dataset code used. |
| `datasetLabel` | Human-readable dataset title. |
| `geo` / `geoLabel` | Country or area code and name. |
| `time` | Observation period (year, quarter, or month). |
| `value` | Observed value, parsed as a number. |
| `unit` / `unitCode` | Unit of measure label and code. |
| `<dim>` / `<dim>Label` | Every other dimension present (e.g. `sex`, `age`, `coicop`, `na_item`) with its code and label. |
| `observedAt` | When the record was collected. |
| `error` | Error message, if any (null on success). |

When `withAiInsight` is on, one extra row with `recordType: "ai_insight"` is added, carrying `aiTrend`, `aiCrossCountryComparison`, and `aiNotableObservations`.

### Use cases

- **EU economic data** feeds for dashboards, apps, and reports across all member states.
- **Unemployment, inflation, and GDP** tracking with harmonized, comparable figures by country.
- **Market research** and country comparisons for expansion, sales, and investment decisions.
- **Fintech and treasury** models that need official EU macro indicators.
- **Academic and policy research** pulling clean tidy series without JSON-stat parsing.
- **Automated monitoring** of any of the thousands of Eurostat datasets on a schedule.

### Billing

This actor uses pay-per-event pricing:

| Event | Price | When it is charged |
| --- | --- | --- |
| `result` | $0.008 | Per observation row returned. |
| `ai_insight` | $0.012 | Once per run, only when the optional AI trend insight produces usable output. Off by default and disabled for free plans. |

You are never charged on failure. Bad dataset codes and empty results return an unbilled note row.

### Notes and limitations

- Data comes from the official Eurostat dissemination API. Values are returned exactly as published; missing observations are skipped, never fabricated.
- Availability of the latest periods depends on Eurostat's own release calendar (for example monthly series may lag by a month or two).
- Dimension codes (unit, coicop, na\_item, and so on) follow Eurostat conventions. Use `filters` to target the exact breakdown you need.

# Actor input Schema

## `dataset` (type: `string`):

A friendly preset alias or a raw Eurostat dataset code. Presets: unemployment (une\_rt\_m), inflation (prc\_hicp\_manr), gdp (namq\_10\_gdp), population (demo\_pjan), gdp\_growth (tec00115). Any raw Eurostat code (e.g. nrg\_bal\_c, tet00002) is also accepted.

## `geo` (type: `array`):

Country or area codes to include, e.g. DE, FR, ES, IT. Use EA for the euro area or EU27\_2020 for the EU-27 aggregate. Leave empty to return every geo the dataset provides.

## `sinceTimePeriod` (type: `string`):

Earliest period to return, e.g. 2020 (annual), 2024-Q1 (quarterly) or 2026-01 (monthly). If both since and until are empty, the last 12 periods are returned.

## `untilTimePeriod` (type: `string`):

Latest period to return, e.g. 2026 or 2026-07. Optional.

## `filters` (type: `object`):

Power-user passthrough of arbitrary Eurostat dimension = value pairs, e.g. {"unit": "PC\_ACT", "sex": "T", "age": "TOTAL"}. Values here override the preset defaults. A value may also be an array to request several categories of one dimension.

## `withAiInsight` (type: `boolean`):

Opt-in AI-generated plain-English trend insight over the returned series (overall direction, cross-country comparison, notable observations). One call and one charge per run, only on usable output. Disabled for free Apify plans.

## `maxResults` (type: `integer`):

Maximum number of observation rows to return. Free Apify plans are capped at 10 rows per run.

## `proxyConfiguration` (type: `object`):

Optional proxy. Eurostat is a keyless public API and normally needs no proxy.

## Actor input object example

```json
{
  "dataset": "unemployment",
  "geo": [
    "DE",
    "ES",
    "FR"
  ],
  "withAiInsight": false,
  "maxResults": 5000
}
```

# 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 = {
    "dataset": "unemployment",
    "geo": [
        "DE",
        "ES",
        "FR"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/eurostat-eu-statistics-scraper").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 = {
    "dataset": "unemployment",
    "geo": [
        "DE",
        "ES",
        "FR",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/eurostat-eu-statistics-scraper").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 '{
  "dataset": "unemployment",
  "geo": [
    "DE",
    "ES",
    "FR"
  ]
}' |
apify call scrapers_lat/eurostat-eu-statistics-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/eurostat-eu-statistics-scraper"
        }
    }
}

```

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/32nur5ATc6y1TcFOV/builds/oAj7UCIbO7Jg9C29F/openapi.json