# Eurostat Income Distribution (EU-SILC) — Per Record (`nexgensignal/eurostat-income-distribution`) Actor

Official Eurostat EU-SILC income distribution statistics as per-record data — national aggregates by age group and sex, verbatim from the source. No API key. Pay per record. Part of NexGen Signal — official-source data products.

- **URL**: https://apify.com/nexgensignal/eurostat-income-distribution.md
- **Developed by:** [NexGen Signal](https://apify.com/nexgensignal) (community)
- **Categories:** Business, News, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $33.50 / 1,000 income distribution records

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

## Eurostat Income Distribution (EU-SILC) — Per Record

**Official source. No API key. Pay per record.**

This actor turns Eurostat's EU-SILC income distribution statistics (dataset ilc\_di03) into clean, per-record data. Each run reads the figures directly from Eurostat's public JSON-stat dissemination API and delivers one record per observation — the country, the age group, the sex, the statistic, the unit, the year, and the value, verbatim from the source. These are national aggregate distribution statistics (such as mean and median income by demographic breakdown). No household- or person-level data exists in the source and none is ever constructed.

### Who buys this and for what job

- **Social and economic researchers** comparing income distribution across EU countries and demographic groups.
- **Policy and think-tank teams** feeding official EU-SILC aggregates into analysis with provenance intact.
- **Journalists** who need the exact national figures by age group and sex behind an inequality story.
- **Data engineers** wanting a keyless, one-call official series for a pipeline.

The job it does: get the official income distribution (eu-silc) series as rows — reliably, with provenance, and without an account or key at the source.

### Pricing

Pay per event. One event: a delivered record. Tiered by your Apify plan; the record is delivered before it is charged. No start fee, no subscription. Blocked runs and empty results cost nothing.

| Event | Free plan | Bronze | Silver | Gold / Platinum / Diamond |
|-------|-----------|--------|--------|---------------------------|
| `income_distribution_record` | $0.05 | $0.045 | $0.04 | $0.0335 |

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `sinceTimePeriod` | string | `2024` | Earliest period to return. Earlier start = more history and more records. |
| `maxRecords` | integer | `500` | Ceiling on records delivered and billed. The default is a fast bounded sample; raise it to pull the full set. |

Both are optional; the default run is a bounded sample that finishes quickly so you can see the shape before scaling up.

### Output

One JSON object per observation. Every dimension is emitted as a code and a label, both verbatim from Eurostat; a composite `record_id` uniquely identifies each row so no two source observations collapse together. Example record from a real run:

```json
{
  "record_id": "A:TOTAL:F:MEAN_EI:EUR:AT:2024",
  "dataset_code": "ilc_di03",
  "indicator": "Income distribution (EU-SILC)",
  "freq": "A",
  "freq_label": "Annual",
  "age": "TOTAL",
  "age_label": "Total",
  "sex": "F",
  "sex_label": "Females",
  "statinfo": "MEAN_EI",
  "statinfo_label": "Mean equivalised income",
  "unit": "EUR",
  "unit_label": "Euro",
  "geo": "AT",
  "geo_label": "Austria",
  "time": "2024",
  "time_label": "2024",
  "value": 36133,
  "obs_status": null,
  "source": "Eurostat",
  "source_dataset": "ilc_di03",
  "licence": "Eurostat, CC BY 4.0. Reformatted from Eurostat JSON-stat; values unmodified. Third-party content and logos excluded. Commercial-barred geographies removed.",
  "attribution": "Source: Eurostat (dataset ilc_di03)",
  "caveat": "National EU-SILC aggregate distribution statistics by age group and sex — no household- or person-level data exists in the source or is ever constructed. Suppressed/missing values excluded and counted. Annual.",
  "observed_at": "2026-08-17T00:00:00Z"
}
```

Every run also writes an unbilled `RUN_RECEIPT` to the run's key-value store: the robots check, the source URL, how many observations were present, delivered, excluded as missing or as commercial-barred geographies, and whether charged equals delivered.

### Cost guidance

One `income_distribution_record` is billed per delivered observation, so cost = records pulled × your plan's per-record price. The full permitted set from `2024` is roughly **25,872** records — about **$1,294** on the Free-plan rate, or about **$867** at the Gold-tier rate. A default 500-record sample is about **$25** (Free) or **$16.75** (Gold). You control volume with `sinceTimePeriod` and `maxRecords`.

### Honest limitations and caveats

- National aggregate only — by age group and sex. No individual, household, or person-level records exist in the source or are ever produced.
- Cadence: annual. Some breakdowns are suppressed or missing; those are excluded and counted, never zero-filled.
- Different statistics (mean, median) and units are distinct rows; read the fields before comparing.
- **Coverage is licence-limited by design.** Eurostat permits commercial reuse only for EU, EFTA, and official acceding/candidate countries; geographies outside that set are excluded at ingest and counted in the run receipt. This is a compliance choice, not a data gap.
- **Missing observations are excluded, never invented;** published zeros are kept as real values.
- **Values, units, statuses, and dimension codes are reproduced verbatim** — never rescaled, relabelled, or re-derived.

### The NexGen Signal family

Part of the NexGen Signal family of official-source, per-record Eurostat products. Its live siblings on the store — all official source, no API key, values verbatim, pay per record:

- [Eurostat House Price Index](https://apify.com/nexgensignal/eurostat-house-price-index)
- [Eurostat Waste Generation](https://apify.com/nexgensignal/eurostat-waste-generation)
- [Eurostat Waste Treatment](https://apify.com/nexgensignal/eurostat-waste-treatment)
- [Eurostat Business & Consumer Confidence](https://apify.com/nexgensignal/eurostat-business-confidence)

*Source: Eurostat. Reformatted from the Eurostat JSON-stat dissemination API; values unmodified. Third-party content and logos excluded. Data for geographies outside EU/EFTA/candidate countries is excluded in line with Eurostat's reuse terms.*

# Actor input Schema

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

Return observations from this period onward (e.g. 2024). Earlier = more records.

## `maxRecords` (type: `integer`):

Maximum records delivered and billed. You are billed only for records delivered. Raise to pull the full set.

## Actor input object example

```json
{
  "sinceTimePeriod": "2024",
  "maxRecords": 500
}
```

# Actor output Schema

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

The delivered Income distribution (EU-SILC) records.

# 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 = {
    "sinceTimePeriod": "2024",
    "maxRecords": 500
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgensignal/eurostat-income-distribution").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 = {
    "sinceTimePeriod": "2024",
    "maxRecords": 500,
}

# Run the Actor and wait for it to finish
run = client.actor("nexgensignal/eurostat-income-distribution").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 '{
  "sinceTimePeriod": "2024",
  "maxRecords": 500
}' |
apify call nexgensignal/eurostat-income-distribution --silent --output-dataset

```

## MCP server setup

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

```

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/TuXA3JDgwHLcq9kZs/builds/ceIn1X9bfIcOZNNKA/openapi.json