# ECB Euro Financial Data Scraper: FX, Rates, Inflation (`scrapers_lat/ecb-euro-financial-data-scraper`) Actor

Official European Central Bank data: euro FX reference rates (EUR vs ~40 currencies), ECB key policy rates, euro-area HICP inflation and AAA government bond yields. Friendly presets, raw series passthrough, date filters, optional AI trend insight. JSON, CSV, Excel.

- **URL**: https://apify.com/scrapers\_lat/ecb-euro-financial-data-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools, 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/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

[![ECB Euro Financial Data Scraper](https://scrapers.lat/banners/ecb-euro-financial-data-scraper.png)](https://apify.com/scrapers_lat/ecb-euro-financial-data-scraper)

## ECB Euro Financial Data Scraper

Get official **European Central Bank** statistics as tidy, ready-to-use JSON rows: **euro foreign-exchange reference rates** (EUR vs ~40 currencies), the **ECB key policy interest rates**, **euro-area HICP inflation**, and **euro-area government bond yields**. Friendly one-click presets, a raw-series passthrough for power users, flexible date ranges, and an optional AI trend insight.

Perfect for fintech apps, treasury and FX operations, economic research, and compliance teams that convert to euros at the official ECB reference rate.

### What you get

One clean row per observation, with the value already parsed as a number and labelled with its date, series title, frequency, and unit. No SDMX wrangling on your side.

```json
{
  "dataset": "exchange_rates",
  "flowRef": "EXR",
  "seriesKey": "D.USD.EUR.SP00.A",
  "seriesLabel": "USD/EUR reference rate",
  "date": "2026-08-14",
  "value": 1.1567,
  "title": "ECB reference exchange rate, US dollar/Euro, 2.15 pm (C.E.T.)",
  "frequency": "Daily",
  "unit": "US dollar",
  "observedAt": "2026-08-16T20:23:07.055Z",
  "error": null
}
```

### Datasets (presets)

| Dataset | What it returns | Key options |
| --- | --- | --- |
| `exchange_rates` | Daily euro FX reference rate, EUR vs a currency you choose (units of that currency per 1 euro) | `currency` (USD, GBP, JPY, CHF, CNY, AUD, CAD, SEK, PLN, ...) |
| `policy_rates` | ECB key interest rates: main refinancing, deposit facility, marginal lending | `rateType` (main, deposit, lending, all) |
| `inflation_hicp` | Euro-area HICP annual rate of change (headline inflation), monthly | date range / last N |
| `yield_curve` | Euro-area AAA government bond spot yield, 10Y, daily | date range / last N |
| `raw` | Any ECB series you want, using your own dataflow and key | `flowRef` + `key` |

### Input

| Field | Type | Description |
| --- | --- | --- |
| `dataset` | string | Preset to pull: `exchange_rates`, `policy_rates`, `inflation_hicp`, `yield_curve`, or `raw`. |
| `currency` | string | For `exchange_rates`: 3-letter ISO code quoted against the euro. Default USD. |
| `rateType` | string | For `policy_rates`: `main`, `deposit`, `lending`, or `all`. |
| `flowRef` | string | For `raw`: the ECB dataflow reference (EXR, FM, ICP, YC, BSI, MIR, ...). |
| `key` | string | For `raw`: the ECB series key, for example `D.GBP.EUR.SP00.A`. |
| `lastNObservations` | integer | Return the most recent N observations. Default 30. Free plans capped at 10. |
| `dateFrom` / `dateTo` | string | Optional period range (YYYY-MM-DD, or YYYY-MM / YYYY). When both are set they take precedence over `lastNObservations`. |
| `withAiInsight` | boolean | Opt-in AI trend summary of the returned series (paid add-on, one charge per run). |

### Output fields

| Field | Description |
| --- | --- |
| `dataset` | The preset used (or `raw`). |
| `flowRef` | ECB dataflow used for the request. |
| `seriesKey` | ECB series key requested. |
| `seriesLabel` | Human-readable label (currency name or policy rate / series name). |
| `date` | Observation date or period. |
| `value` | Observation value as a number (null observations are skipped). |
| `title` | Full ECB series title. |
| `frequency` | Series frequency (Daily, Monthly, ...). |
| `unit` | Unit of the observation (US dollar, Percent per annum, Index, ...). |
| `observedAt` | Timestamp of the scrape. |
| `error` | Populated only if a request failed; that row is never billed. |

### Use cases

- **FX and treasury**: pull the official euro reference rate for USD, GBP, JPY, CHF, CNY and dozens more to price invoices, revalue balances, and hedge exposure.
- **Compliance and accounting**: convert to euros at the recognised ECB reference rate for VAT, transfer pricing, and financial reporting.
- **Fintech and dashboards**: feed live euro exchange rates, policy rates, inflation, and bond yields into apps, alerts, and analytics.
- **Economic research**: track ECB monetary policy, euro-area HICP inflation, and the government bond yield curve over any date range.
- **Rate monitoring**: watch the main refinancing, deposit facility, and marginal lending rates for policy changes.

### Billing

This actor uses pay-per-event pricing:

- **result** ($0.008): one ECB observation row (FX rate, policy rate, inflation reading, bond yield, or raw series point). Failed requests emit an unbilled `error` row and are never charged.
- **AI trend insight** ($0.012): optional, opt-in via `withAiInsight`. After fetching the series, one AI call summarizes the trend in plain English (direction, quantified change, notable observations). Emitted as a single `ai_insight` row and charged once per run, only when usable output is produced. Disabled for free Apify users.

Free Apify plans are capped at 10 results per run. Data comes from the official ECB Data Portal.

# Actor input Schema

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

Which European Central Bank dataset to pull. exchange\_rates = daily euro FX reference rate (EUR vs a currency you choose); policy\_rates = ECB key interest rates (main refinancing, deposit facility, marginal lending); inflation\_hicp = euro-area HICP annual inflation rate; yield\_curve = euro-area AAA government bond spot yield (10Y). Choose raw to hit any ECB series with your own flowRef + key.

## `currency` (type: `string`):

For exchange\_rates only: the foreign currency quoted against the euro, as a 3-letter ISO code. Examples: USD, GBP, JPY, CHF, CNY, AUD, CAD, SEK, PLN. The value is units of this currency per 1 euro (ECB reference rate).

## `rateType` (type: `string`):

For policy\_rates only: which ECB key interest rate to fetch. Choose all to return all three.

## `flowRef` (type: `string`):

For the raw dataset only: the ECB dataflow reference, for example EXR, FM, ICP, YC, BSI, MIR. Combined with the series key below.

## `key` (type: `string`):

For the raw dataset only: the ECB series key, for example D.GBP.EUR.SP00.A for the GBP/EUR reference rate. Find keys in the ECB Data Portal.

## `lastNObservations` (type: `integer`):

Return the most recent N observations of the series. Ignored when both Date from and Date to are set. Free Apify plans are capped at 10 per run.

## `dateFrom` (type: `string`):

Optional start period (YYYY-MM-DD, or YYYY-MM / YYYY for monthly/annual series). When both Date from and Date to are provided they take precedence over Last N observations.

## `dateTo` (type: `string`):

Optional end period (YYYY-MM-DD, or YYYY-MM / YYYY).

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

Opt-in AI add-on ($0.012 per run, not per row). After fetching the series, make ONE AI call (OpenRouter gpt-4o-mini) that summarizes the trend in plain English: overall direction, quantified change from start to end, and notable observations. Emitted as a single ai\_insight row and charged once, only when usable output is produced. Disabled for free Apify users.

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

Optional. The ECB Data Portal API is open and needs no proxy, but you can route requests through an Apify proxy if you prefer.

## Actor input object example

```json
{
  "dataset": "exchange_rates",
  "currency": "USD",
  "rateType": "main",
  "lastNObservations": 30,
  "withAiInsight": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 = {
    "lastNObservations": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/ecb-euro-financial-data-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 = { "lastNObservations": 30 }

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/ecb-euro-financial-data-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 '{
  "lastNObservations": 30
}' |
apify call scrapers_lat/ecb-euro-financial-data-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/ecb-euro-financial-data-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/x0MoaJr7kYtvF1h2F/builds/JU1sCWk8r51snVVEt/openapi.json