{
  "openapi": "3.0.1",
  "info": {
    "title": "EU Airport Passengers by Month and Port Freight: Eurostat",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "m7lXJWNC1UBI6i3c2"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/yappman~aviation-airport-traffic-eu/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-yappman-aviation-airport-traffic-eu",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/yappman~aviation-airport-traffic-eu/runs": {
      "post": {
        "operationId": "runs-sync-yappman-aviation-airport-traffic-eu",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/yappman~aviation-airport-traffic-eu/run-sync": {
      "post": {
        "operationId": "run-sync-yappman-aviation-airport-traffic-eu",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "airport",
              "route",
              "ranking",
              "changes",
              "port",
              "portRanking"
            ],
            "type": "string",
            "description": "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.",
            "default": "airport"
          },
          "airports": {
            "title": "Airports",
            "maxItems": 50,
            "type": "array",
            "description": "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.",
            "default": [
              "VIE",
              "EHAM"
            ],
            "items": {
              "type": "string"
            }
          },
          "partnerAirports": {
            "title": "Partner airports (route mode)",
            "maxItems": 50,
            "type": "array",
            "description": "Optional IATA or ICAO codes. Route mode returns only pairs whose other end is in this list; empty returns every partner Eurostat lists.",
            "items": {
              "type": "string"
            }
          },
          "fromMonth": {
            "title": "From month",
            "type": "string",
            "description": "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": {
            "title": "To month",
            "type": "string",
            "description": "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": {
            "title": "Month (ranking)",
            "type": "string",
            "description": "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": {
            "title": "Country",
            "type": "string",
            "description": "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": {
            "title": "Ports (port mode)",
            "maxItems": 30,
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "measure": {
            "title": "Measure (ports)",
            "enum": [
              "goods",
              "passengers"
            ],
            "type": "string",
            "description": "Port and portRanking modes: goods (gross weight, thousand tonnes) or passengers (thousand, excluding cruise passengers; quarterly only).",
            "default": "goods"
          },
          "frequency": {
            "title": "Frequency (ports)",
            "enum": [
              "Q",
              "A"
            ],
            "type": "string",
            "description": "Port and portRanking modes: Q quarterly or A annual (goods only).",
            "default": "Q"
          },
          "fromPeriod": {
            "title": "From period (port mode)",
            "type": "string",
            "description": "Port mode: first quarter (2025-Q1) or year (2023). Default: 8 quarters or 5 years up to the last period."
          },
          "toPeriod": {
            "title": "To period (port mode)",
            "type": "string",
            "description": "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": {
            "title": "Top N (ranking and portRanking)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Ranking and portRanking modes: how many to return.",
            "default": 20
          },
          "snapshotName": {
            "title": "Snapshot name (changes)",
            "type": "string",
            "description": "Changes mode only: the name of your saved snapshot. The first run saves a baseline and returns no rows; later runs return what changed.",
            "default": "default"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}