{
  "openapi": "3.0.1",
  "info": {
    "title": "Ryanair Flights Scraper: Fares, Seats & Schedules",
    "description": "Scrape Ryanair fares and flight availability between 230+ European airports by IATA code and date. Extract price, currency, flight number, seats left, duration, stops and booking deep link. Export to JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "od1DmPVfaHX20OvXT"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapers_lat~ryanair-flights-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapers_lat-ryanair-flights-scraper",
        "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/scrapers_lat~ryanair-flights-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapers_lat-ryanair-flights-scraper",
        "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/scrapers_lat~ryanair-flights-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapers_lat-ryanair-flights-scraper",
        "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",
        "required": [
          "origin",
          "destination",
          "departureDateFrom"
        ],
        "properties": {
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of fare records to collect. Optional."
          },
          "withDetails": {
            "title": "Fetch flight availability details",
            "type": "boolean",
            "description": "When enabled, the scraper makes a second request per day to retrieve every flight with seats left, duration, operating carrier and fare types. Adds a separate details event per flight.",
            "default": true
          },
          "origin": {
            "title": "Origin airport",
            "enum": [
              "AAR",
              "ABZ",
              "ACE",
              "AGA",
              "AGP",
              "AHO",
              "ALC",
              "AMM",
              "AMS",
              "AOI",
              "ARN",
              "ATH",
              "BBU",
              "BCN",
              "BDS",
              "BEM",
              "BER",
              "BFS",
              "BGY",
              "BHX",
              "BIQ",
              "BJV",
              "BLQ",
              "BNX",
              "BOH",
              "BOJ",
              "BRE",
              "BRI",
              "BRQ",
              "BRS",
              "BRU",
              "BSL",
              "BTS",
              "BUD",
              "BVA",
              "BVE",
              "BZG",
              "BZR",
              "CAG",
              "CCF",
              "CDT",
              "CFU",
              "CGN",
              "CHQ",
              "CIA",
              "CLJ",
              "CPH",
              "CRL",
              "CRV",
              "CTA",
              "CUF",
              "CWL",
              "DBV",
              "DLE",
              "DLM",
              "DUB",
              "EDI",
              "EFL",
              "EGC",
              "EIN",
              "EMA",
              "ERH",
              "ESU",
              "EXT",
              "FAO",
              "FCO",
              "FDH",
              "FEZ",
              "FKB",
              "FMM",
              "FMO",
              "FNC",
              "FNI",
              "FRL",
              "FSC",
              "FUE",
              "GDN",
              "GLA",
              "GNB",
              "GOA",
              "GOT",
              "GRO",
              "HAM",
              "HEL",
              "HER",
              "HHN",
              "IAS",
              "IBZ",
              "INI",
              "JMK",
              "JSI",
              "JTR",
              "KGS",
              "KIR",
              "KLU",
              "KLX",
              "KRK",
              "KSC",
              "KTW",
              "KUN",
              "LBA",
              "LBC",
              "LCA",
              "LCJ",
              "LDE",
              "LDY",
              "LEI",
              "LGW",
              "LIG",
              "LIL",
              "LIS",
              "LNZ",
              "LPA",
              "LPL",
              "LRH",
              "LTN",
              "LUX",
              "LUZ",
              "LXS",
              "MAD",
              "MAH",
              "MAN",
              "MLA",
              "MME",
              "MMX",
              "MRS",
              "MXP",
              "NAP",
              "NCE",
              "NCL",
              "NDR",
              "NOC",
              "NQY",
              "NRN",
              "NTE",
              "NUE",
              "NWI",
              "OLB",
              "OPO",
              "ORK",
              "OSI",
              "OSL",
              "OSR",
              "OTP",
              "OUD",
              "OZZ",
              "PAD",
              "PDV",
              "PED",
              "PEG",
              "PFO",
              "PGF",
              "PIK",
              "PIS",
              "PLQ",
              "PMF",
              "PMI",
              "PMO",
              "POZ",
              "PRG",
              "PSA",
              "PSR",
              "PUY",
              "PVK",
              "QSR",
              "RAK",
              "RBA",
              "RDZ",
              "REG",
              "REU",
              "RHO",
              "RIX",
              "RJK",
              "RMI",
              "RMU",
              "RVN",
              "RZE",
              "SCN",
              "SCQ",
              "SDR",
              "SFT",
              "SJJ",
              "SKG",
              "SNN",
              "SOF",
              "SPU",
              "STN",
              "SUF",
              "SVQ",
              "SZG",
              "SZY",
              "SZZ",
              "TFS",
              "TGD",
              "TIA",
              "TLL",
              "TLS",
              "TNG",
              "TPS",
              "TRF",
              "TRN",
              "TRS",
              "TSF",
              "TTU",
              "TUF",
              "VAR",
              "VCE",
              "VIE",
              "VIL",
              "VIT",
              "VLC",
              "VNO",
              "VOL",
              "VRN",
              "VST",
              "VXO",
              "WAW",
              "WMI",
              "WRO",
              "XCR",
              "ZAD",
              "ZAG",
              "ZAZ",
              "ZTH"
            ],
            "type": "string",
            "description": "Departure airport IATA code."
          },
          "destination": {
            "title": "Destination airport",
            "enum": [
              "AAR",
              "ABZ",
              "ACE",
              "AGA",
              "AGP",
              "AHO",
              "ALC",
              "AMM",
              "AMS",
              "AOI",
              "ARN",
              "ATH",
              "BBU",
              "BCN",
              "BDS",
              "BEM",
              "BER",
              "BFS",
              "BGY",
              "BHX",
              "BIQ",
              "BJV",
              "BLQ",
              "BNX",
              "BOH",
              "BOJ",
              "BRE",
              "BRI",
              "BRQ",
              "BRS",
              "BRU",
              "BSL",
              "BTS",
              "BUD",
              "BVA",
              "BVE",
              "BZG",
              "BZR",
              "CAG",
              "CCF",
              "CDT",
              "CFU",
              "CGN",
              "CHQ",
              "CIA",
              "CLJ",
              "CPH",
              "CRL",
              "CRV",
              "CTA",
              "CUF",
              "CWL",
              "DBV",
              "DLE",
              "DLM",
              "DUB",
              "EDI",
              "EFL",
              "EGC",
              "EIN",
              "EMA",
              "ERH",
              "ESU",
              "EXT",
              "FAO",
              "FCO",
              "FDH",
              "FEZ",
              "FKB",
              "FMM",
              "FMO",
              "FNC",
              "FNI",
              "FRL",
              "FSC",
              "FUE",
              "GDN",
              "GLA",
              "GNB",
              "GOA",
              "GOT",
              "GRO",
              "HAM",
              "HEL",
              "HER",
              "HHN",
              "IAS",
              "IBZ",
              "INI",
              "JMK",
              "JSI",
              "JTR",
              "KGS",
              "KIR",
              "KLU",
              "KLX",
              "KRK",
              "KSC",
              "KTW",
              "KUN",
              "LBA",
              "LBC",
              "LCA",
              "LCJ",
              "LDE",
              "LDY",
              "LEI",
              "LGW",
              "LIG",
              "LIL",
              "LIS",
              "LNZ",
              "LPA",
              "LPL",
              "LRH",
              "LTN",
              "LUX",
              "LUZ",
              "LXS",
              "MAD",
              "MAH",
              "MAN",
              "MLA",
              "MME",
              "MMX",
              "MRS",
              "MXP",
              "NAP",
              "NCE",
              "NCL",
              "NDR",
              "NOC",
              "NQY",
              "NRN",
              "NTE",
              "NUE",
              "NWI",
              "OLB",
              "OPO",
              "ORK",
              "OSI",
              "OSL",
              "OSR",
              "OTP",
              "OUD",
              "OZZ",
              "PAD",
              "PDV",
              "PED",
              "PEG",
              "PFO",
              "PGF",
              "PIK",
              "PIS",
              "PLQ",
              "PMF",
              "PMI",
              "PMO",
              "POZ",
              "PRG",
              "PSA",
              "PSR",
              "PUY",
              "PVK",
              "QSR",
              "RAK",
              "RBA",
              "RDZ",
              "REG",
              "REU",
              "RHO",
              "RIX",
              "RJK",
              "RMI",
              "RMU",
              "RVN",
              "RZE",
              "SCN",
              "SCQ",
              "SDR",
              "SFT",
              "SJJ",
              "SKG",
              "SNN",
              "SOF",
              "SPU",
              "STN",
              "SUF",
              "SVQ",
              "SZG",
              "SZY",
              "SZZ",
              "TFS",
              "TGD",
              "TIA",
              "TLL",
              "TLS",
              "TNG",
              "TPS",
              "TRF",
              "TRN",
              "TRS",
              "TSF",
              "TTU",
              "TUF",
              "VAR",
              "VCE",
              "VIE",
              "VIL",
              "VIT",
              "VLC",
              "VNO",
              "VOL",
              "VRN",
              "VST",
              "VXO",
              "WAW",
              "WMI",
              "WRO",
              "XCR",
              "ZAD",
              "ZAG",
              "ZAZ",
              "ZTH"
            ],
            "type": "string",
            "description": "Arrival airport IATA code."
          },
          "departureDateFrom": {
            "title": "Departure date from",
            "type": "string",
            "description": "Earliest outbound date (YYYY-MM-DD)."
          },
          "departureDateTo": {
            "title": "Departure date to",
            "type": "string",
            "description": "Latest outbound date (YYYY-MM-DD). Leave empty to use the same day as Departure date from."
          },
          "tripType": {
            "title": "Trip type",
            "enum": [
              "oneWay",
              "round"
            ],
            "type": "string",
            "description": "One-way or round trip.",
            "default": "oneWay"
          },
          "returnDateFrom": {
            "title": "Return date from",
            "type": "string",
            "description": "Earliest inbound date (YYYY-MM-DD). Round trips only."
          },
          "returnDateTo": {
            "title": "Return date to",
            "type": "string",
            "description": "Latest inbound date (YYYY-MM-DD). Round trips only."
          },
          "currency": {
            "title": "Currency",
            "enum": [
              "EUR",
              "GBP",
              "USD",
              "PLN",
              "SEK",
              "DKK",
              "NOK",
              "CHF",
              "HUF",
              "RON",
              "BGN",
              "CZK"
            ],
            "type": "string",
            "description": "Currency for the fare scan prices.",
            "default": "EUR"
          },
          "adults": {
            "title": "Adults",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "Number of adult passengers (affects seat availability counts).",
            "default": 1
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}