# EU Airport Passengers by Month and Port Freight: Eurostat (`yappman/aviation-airport-traffic-eu`) Actor

Monthly passengers and flights at EU and EFTA airports, airport-pair passengers, and goods and passengers at EU ports, from Eurostat open data in one fixed row schema, with reference month, release date and source on every row. Charged per run and per row.

- **URL**: https://apify.com/yappman/aviation-airport-traffic-eu.md
- **Developed by:** [Russell Yapp](https://apify.com/yappman) (community)
- **Categories:** Travel, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 33.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 data rows

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

## EU Airport Passengers by Month and Port Freight: Eurostat

Returns a dated copy of Eurostat open data on passengers and flights at EU and EFTA airports, passengers between airport pairs, and goods and passengers at ports, as one fixed row schema. You name airports by IATA or ICAO code and ports by Eurostat port key, location code or name; every row says which Eurostat dataset it came from, which month it covers, when Eurostat last updated that dataset, when this Actor read it, and carries the source statement you need to keep with the data.

Data source: Eurostat, datasets avia_paoa (airport passengers and flights, monthly), avia_par_XX (airport pairs, one dataset per reporting country), mar_go_qm_XX and mar_go_am_XX (goods at ports, quarterly and annual) and mar_pa_qm_XX (passengers at ports, quarterly). Airport names, codes and coordinates come from OurAirports (public domain). The data is reformatted, filtered and joined to the airport table by Yappman Data. It is not endorsed by Eurostat or the European Commission.

### Quick spec for AI agents

- Purpose: monthly passenger and flight counts for named EU/EFTA airports, route-pair passengers, a top-N airport ranking for a month, and a feed of values that are new or revised since your last run.
- Input: `mode` (`airport`, `route`, `ranking`, `changes`, `port`, `portRanking`), `airports` (IATA or ICAO codes), `fromMonth` and `toMonth` (`YYYY-MM`), plus `partnerAirports` (route), `period`, `country`, `topN` (ranking), `snapshotName` (changes). Port modes: `country` (required), `ports`, `measure` (`goods` or `passengers`), `frequency` (`Q` or `A`), `fromPeriod`, `toPeriod`, `period`, `topN`.
- Output: one dataset row per airport and month (`airportMonth`), per airport pair and month (`routeMonth`), per ranked airport (`rankingMonth`), per changed value (`change`), per port and period (`portPeriod`), per ranked port (`portRanking`). Numbers Eurostat does not publish are `null`, never zero.
- Every row carries: `sourceDataset`, `sourceDoi`, `period`, `releaseDate` (Eurostat's own last update of the dataset), `retrievedAt`, `flags` (Eurostat observation flags such as provisional) and `attribution`.
- Run summary: key `RUN_SUMMARY` in the key-value store, with counts per airport, the reason for any airport without data, the datasets read with their release dates, and what was charged.
- Charging: pay per event, one `run` event per run that returns at least one row (and for a changes-mode baseline run) and one `row` event per row returned. A run with no rows is not charged and its summary carries only reason codes.
- Limits: at most 50 airports and 36 months in airport and changes modes; 10 airports and 24 months in route mode; ranking returns at most 100 airports.
- Not provided: real-time or intraday data, delays, fares, airline-level figures, or anything not in the Eurostat datasets above.

### Minimal example inputs

Airport months:

```json
{ "mode": "airport", "airports": ["VIE", "EHAM"], "fromMonth": "2025-01", "toMonth": "2025-12" }
```

Route pairs from one airport to two partners:

```json
{ "mode": "route", "airports": ["LEMD"], "partnerAirports": ["VIE", "AMS"], "fromMonth": "2024-01", "toMonth": "2024-12" }
```

Top 10 airports in Poland for one month:

```json
{ "mode": "ranking", "country": "PL", "period": "2026-06", "topN": 10 }
```

Changes since the last run (the first run with a name saves a baseline and returns no rows):

```json
{ "mode": "changes", "airports": ["VIE", "EHAM"], "snapshotName": "my-feed" }
```

Ports of one country, goods, quarterly:

```json
{ "mode": "port", "country": "NL", "ports": ["Rotterdam", "NLAMS"], "measure": "goods", "frequency": "Q", "fromPeriod": "2025-Q1", "toPeriod": "2026-Q1" }
```

Top 5 ports of Spain for one quarter by passengers:

```json
{ "mode": "portRanking", "country": "ES", "measure": "passengers", "period": "2026-Q1", "topN": 5 }
```

### Modes

- airport: one row per airport and month with passengers carried, arrivals, departures, national, international, intra-EU, extra-EU, scheduled and non-scheduled passengers, passenger flights (total, arrivals, departures) and the change against the same month a year earlier (worked out by this Actor from the same dataset). If you name no airports in airport mode, the Actor returns Vienna (VIE) and Amsterdam (EHAM), so an input made only of the default values still returns rows.
- route: one row per reporting airport, partner airport and month, with passengers carried and the great-circle distance in kilometres between the two airports with the distance range it falls in (up to 1500 km, over 1500 to 3500 km, over 3500 km, the three distance ranges that Regulation (EC) No 261/2004 uses; which rule applies to a journey also depends on other facts, for example whether the flight is within the EU, so the range is not a statement about any entitlement). The distance is shown rounded to one decimal; the range is worked out from the unrounded distance. The distance is geographic information about two airports only. It is not advice on passenger rights or compensation, it says nothing about any flight, and the legal distance for a booking is measured to the last destination of that booking. Eurostat route data comes out about a year later than airport data.
- ranking: the busiest airports for one month. If you give no month, the Actor uses the latest of the last six months in which at least 90 percent of the best month's airports have a value, and the run summary lists the countries that had no value for that month.
- port: one row per port and period with inbound, outbound and total goods weight (thousand tonnes) or passengers (thousand, cruise passengers excluded), and the change against the same period a year earlier. Passengers are quarterly only. Port names come from Eurostat.
- portRanking: the busiest ports of one country for a quarter or year.
- changes: values that are new or revised since your last run with the same snapshot name, with the previous value, the new value and both release dates.

### What the data is, and is not

- It is a dated copy of what Eurostat had published on the day of the read. Each row says that date and Eurostat's own release date.
- Eurostat does not publish every country for the same month at the same time. In the saved check on 19 November 2026, only 13 countries had airport values for August 2026. A missing month means Eurostat had no value then, not that there was no traffic.
- Port data is published per country and quarter, about four to five months after the quarter ends; annual port data comes once a year.
- United Kingdom data: Eurostat airport data for the United Kingdom ends in 2020 and route data ends in 2019, because the United Kingdom no longer reports. Eurostat's reuse terms exclude commercial reuse of data for countries outside the EU, EFTA and candidate countries, and the United Kingdom left the EU on 31 January 2020, so this Actor returns no United Kingdom rows from February 2020 (first quarter for ports, year 2020 for annual data). A request for United Kingdom airports in that period in the Eurostat modes returns no rows and is not charged.
- Values can be revised by Eurostat. Use the changes mode to see revisions.
- It is not a real-time feed, not exhaustive for every airport, and not a forecast. Counts are Eurostat's counts of passengers carried and are not checked by this Actor.
- Not endorsed by Eurostat or the European Commission.

### Pricing

Pay per event: a `row` event for each row returned, and a `run` event for each run that returns at least one row. A run that returns no rows is not charged (the first run of changes mode, which saves your baseline, is the one exception) and its run summary carries a reason code for each airport or port. Amounts are shown on the Actor's pricing tab. There is no start fee. If your spending limit cannot cover a row, the run stops and the run summary says so.

#### Example costs

At the set prices of $0.005 per run and $0.001 per row (the pricing tab shows the amounts that apply to you):

- Vienna airport, 12 months: 12 rows, $0.005 + 12 x $0.001 = $0.017.
- Five airports, 12 months each: 60 rows, $0.065.
- Top 20 airports for one month: 20 rows, $0.025.
- One Dutch port, goods, 8 quarters: 8 rows, $0.013.
- A request that returns no rows, for example United Kingdom airports in 2021: $0.

### Coverage and limits

- Airports: the countries and airports Eurostat lists in avia_paoa (EU, EFTA and candidate countries). Monthly values arrive at different times by country; the newest months are often empty for some countries.
- Routes: pairs reported in the avia_par datasets, one dataset per reporting country; data comes out about a year after the month. Route mode reads a whole country for the months asked, then keeps the airports you named.
- Ports: the ports Eurostat lists in the mar_go and mar_pa datasets by country. Passengers are quarterly only and exclude cruise passengers. Port names are Eurostat's.
- Not covered: the United Kingdom after January 2020, airline-level figures, delays, fares, schedules, any real-time data, and any data from the UK Civil Aviation Authority.
- Limits per run: 50 airports and 36 months (airport and changes), 10 airports and 24 months (route), 30 ports and 20 quarters or 10 years (port), at most 100 rows in the rankings, and at most 40 requests to Eurostat at one per second. A larger job is several runs.
- Every row carries the dataset code, the reference period, Eurostat's release date, the read time and the attribution.

### Data protection

The data is about airports and aggregate passenger counts. It holds no personal data and the Actor collects none.

### Sources and credit

Eurostat reuse is permitted for commercial and non-commercial purposes provided the source is acknowledged; keep the `attribution` field with the data. Airport reference data: OurAirports, released to the public domain.

# Actor input Schema

## `mode` (type: `string`):

Airport: monthly passengers and flights for the airports you name. Route: passengers between a reporting airport and partner airports. Ranking: the busiest airports for one month. Changes: only values new or revised since your last run with the same snapshot name. Port: goods weight or passengers for the ports of one country. PortRanking: the busiest ports of one country for a period.

## `airports` (type: `array`):

IATA (3 letters) or ICAO (4 letters) codes, for example VIE or EHAM. Airport mode: default VIE and EHAM when you name none. Required in route and changes modes (route mode takes at most 10); not used in the other modes.

## `partnerAirports` (type: `array`):

Optional IATA or ICAO codes. Route mode returns only pairs whose other end is in this list; empty returns every partner Eurostat lists.

## `fromMonth` (type: `string`):

First month, written YYYY-MM, for example 2025-01. Default: 12 months up to the end month. At most 36 months (24 in route mode).

## `toMonth` (type: `string`):

Last month, written YYYY-MM, for example 2025-12. Default: 3 months before the current month. Eurostat publishes some countries later than others, so the newest months can be empty.

## `period` (type: `string`):

Ranking mode: the month, YYYY-MM. PortRanking mode: the quarter (2026-Q1) or year.  Default: the latest month in the last six where at least 90 percent of the best month airports have a value.

## `country` (type: `string`):

A two-letter Eurostat country code such as AT, NL or EL. Required in port and portRanking modes. Optional in ranking mode (default all countries). Not used in airport, route and changes modes.

## `ports` (type: `array`):

Port mode only: Eurostat port keys (NL_0NLAMS), five-letter location codes (NLAMS) or a name fragment (at least 3 letters, for example Rotterdam). Empty returns every port Eurostat lists for the country.

## `measure` (type: `string`):

Port and portRanking modes: goods (gross weight, thousand tonnes) or passengers (thousand, excluding cruise passengers; quarterly only).

## `frequency` (type: `string`):

Port and portRanking modes: Q quarterly or A annual (goods only).

## `fromPeriod` (type: `string`):

Port mode: first quarter (2025-Q1) or year (2023). Default: 8 quarters or 5 years up to the last period.

## `toPeriod` (type: `string`):

Port mode: last quarter or year. Default: the quarter six months back, or the year two years back. At most 20 quarters or 10 years.

## `topN` (type: `integer`):

Ranking and portRanking modes: how many to return.

## `snapshotName` (type: `string`):

Changes mode only: the name of your saved snapshot. The first run saves a baseline and returns no rows; later runs return what changed.

## Actor input object example

```json
{
  "mode": "airport",
  "airports": [
    "VIE",
    "EHAM"
  ],
  "country": "NL",
  "measure": "goods",
  "frequency": "Q",
  "topN": 20,
  "snapshotName": "default"
}
```

# Actor output Schema

## `rows` (type: `string`):

No description

## `runSummary` (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 = {
    "mode": "airport",
    "airports": [
        "VIE",
        "EHAM"
    ],
    "country": "NL"
};

// Run the Actor and wait for it to finish
const run = await client.actor("yappman/aviation-airport-traffic-eu").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 = {
    "mode": "airport",
    "airports": [
        "VIE",
        "EHAM",
    ],
    "country": "NL",
}

# Run the Actor and wait for it to finish
run = client.actor("yappman/aviation-airport-traffic-eu").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 '{
  "mode": "airport",
  "airports": [
    "VIE",
    "EHAM"
  ],
  "country": "NL"
}' |
apify call yappman/aviation-airport-traffic-eu --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,yappman/aviation-airport-traffic-eu"
        }
    }
}
```

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/MbXjcIpi4knDDLx9z/builds/m7lXJWNC1UBI6i3c2/openapi.json
