# Ryanair Scraper (`crawlerbros/ryanair-scraper`) Actor Search Ryanair's price calendar for the cheapest one-way and round-trip fares on any route. Explore all destinations from an airport to find the best deals. Returns real-time prices, flight numbers, departure/arrival times, and booking links. - **URL**: https://apify.com/crawlerbros/ryanair-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ## Ryanair Flight Price Scraper Search Ryanair's price calendar for the cheapest one-way and round-trip fares on any route — or explore all cheap destinations from any airport. Returns real-time prices, flight numbers, departure/arrival times, and direct booking links. No API keys, no cookies, and no paid proxy required — runs on the Apify free plan out of the box. ### Features - **One-way fare search** — find the cheapest Ryanair one-way fares between two airports over a date range - **Round-trip fare search** — find the cheapest outbound + return combinations - **Explore destinations** — discover the cheapest fares from any Ryanair airport to all its destinations (great for "where can I go for €20?") - **Airport directory** — list all 220+ Ryanair airports with IATA codes, city/country, coordinates, and time zones - **Price filters** — filter by maximum price, departure day of week, and trip duration - **Direct booking links** — each record includes a deep link to book on ryanair.com ### Use Cases - Monitor flight prices between two cities over a travel window - Find the cheapest weekend getaway from your home airport - Build a travel deals alert system - Research price trends for a specific route ### Input | Field | Type | Description | |---|---|---| | `mode` | select | `searchOneWay`, `searchRoundTrip`, `exploreDestinations`, or `listAirports` | | `origin` | text | IATA code of departure airport (e.g. `STN`, `DUB`, `BCN`) | | `destination` | text | IATA code of arrival airport (required for `searchOneWay` / `searchRoundTrip`) | | `departureDateFrom` | date | Earliest departure date (`YYYY-MM-DD`). Defaults to tomorrow. | | `departureDateTo` | date | Latest departure date. Defaults to 30 days from today. | | `returnDateFrom` | date | Earliest return date (round-trip only). Defaults to `departureDateFrom + 3d`. | | `returnDateTo` | date | Latest return date (round-trip only). Defaults to `departureDateTo + 14d`. | | `adults` | integer | Number of adult passengers (1–9). Default: 1. | | `currency` | select | EUR, GBP, USD, PLN, and 20+ more. Default: EUR. | | `maxPrice` | number | Maximum fare price filter. | | `departureDaysOfWeek` | array | Filter to specific days: 1=Monday, 7=Sunday. | | `minTripDurationDays` | integer | Minimum stay for round trips. | | `maxTripDurationDays` | integer | Maximum stay for round trips. | | `maxItems` | integer | Maximum records to return (1–5000). Default: 100. | #### Example inputs **Search cheapest STN → BCN flights in July 2026:** ```json { "mode": "searchOneWay", "origin": "STN", "destination": "BCN", "departureDateFrom": "2026-07-01", "departureDateTo": "2026-07-31", "currency": "GBP", "maxItems": 50 } ```` **Find cheapest round trips from Dublin in August:** ```json { "mode": "searchRoundTrip", "origin": "DUB", "destination": "BCN", "departureDateFrom": "2026-08-01", "departureDateTo": "2026-08-31", "minTripDurationDays": 3, "maxTripDurationDays": 10, "currency": "EUR" } ``` **Explore all cheap destinations from London Stansted:** ```json { "mode": "exploreDestinations", "origin": "STN", "maxPrice": 30.0, "currency": "EUR", "maxItems": 200 } ``` ### Output Each flight record contains: | Field | Description | |---|---| | `flightNumber` | Ryanair flight number, e.g. `FR8230` | | `airline` | Always `Ryanair` | | `airlineCode` | Always `FR` | | `origin` | IATA code of departure airport | | `originAirportName` | Full name of departure airport | | `originCity` | City served | | `originCountry` | Country of departure airport | | `destination` | IATA code of arrival airport | | `destinationAirportName` | Full name of arrival airport | | `destinationCity` | Destination city | | `destinationCountry` | Country of arrival airport | | `departureDate` | ISO 8601 datetime of departure | | `arrivalDate` | ISO 8601 datetime of arrival | | `durationMinutes` | Flight duration in minutes | | `stops` | Always `0` (Ryanair flies direct only) | | `price` | Fare price in selected currency | | `currency` | ISO 4217 currency code | | `previousPrice` | Previous price (if recently changed) | | `priceChangeAmount` | Change vs previous price (negative = dropped) | | `tripType` | `oneWay` or `roundTrip` | | `adults` | Number of passengers priced | | `bookingUrl` | Direct booking link on ryanair.com | | `scrapedAt` | UTC timestamp of scrape | **Round-trip records also include:** | Field | Description | |---|---| | `inboundFlightNumber` | Return flight number | | `inboundDepartureDate` | Return departure datetime | | `inboundArrivalDate` | Return arrival datetime | | `inboundDurationMinutes` | Return flight duration | | `outboundPrice` | Outbound leg price | | `inboundPrice` | Return leg price | | `totalPrice` | Combined round-trip price | | `tripDurationDays` | Days between outbound and return | #### Sample output record ```json { "flightNumber": "FR8230", "airline": "Ryanair", "airlineCode": "FR", "origin": "STN", "originAirportName": "London Stansted", "originCity": "London", "originCountry": "United Kingdom", "originCountryCode": "gb", "destination": "BCN", "destinationAirportName": "Barcelona", "destinationCity": "Barcelona", "destinationCountry": "Spain", "destinationCountryCode": "es", "departureDate": "2026-08-05T18:20:00", "arrivalDate": "2026-08-05T21:35:00", "durationMinutes": 195, "stops": 0, "price": 17.99, "currency": "EUR", "tripType": "oneWay", "adults": 1, "bookingUrl": "https://www.ryanair.com/gb/en/trip/flights/one-way?ADTCount=1&DateOut=2026-08-05&Destination=BCN&Origin=STN", "recordType": "flight", "scrapedAt": "2026-06-07T10:00:00Z" } ``` ### Data Source Data is sourced from Ryanair's public price-calendar API (`farfnd/v4`), which powers the flight search on ryanair.com. This API returns the **cheapest available fare** per day for a given route — not every individual flight. To see all available flights on a specific date, use the booking link. **Coverage:** 220+ airports across Europe, North Africa, Middle East, and the Canary Islands — everywhere Ryanair flies. **Limitations:** - Returns cheapest fare per day per route, not every individual departure time - Booking API (`/api/booking/v4/availability`) is IP-restricted; actual seat availability requires visiting ryanair.com - Price calendar is typically available 0–180 days in advance - Prices shown are base fares; bags and extras cost extra on Ryanair ### FAQs **Q: Does this require login or API keys?** A: No. The Ryanair price calendar is public and accessible without any credentials. **Q: Is a proxy required?** A: No. The `farfnd/v4` API works from standard datacenter IPs. **Q: How often are prices updated?** A: Ryanair updates prices continuously. Each run fetches live prices at the time of scraping. **Q: Can I search for child fares?** A: The Ryanair farfnd API prices adult fares only. Use the booking URL to check child fares on the Ryanair website. **Q: What does "cheapest fare per day" mean?** A: For a given route and date, Ryanair's price calendar returns the single cheapest fare available on that day. If multiple departures exist, only the cheapest is returned. The booking URL links directly to Ryanair for full availability. **Q: Can I filter by non-stop flights?** A: All Ryanair flights are direct (no stops), so `stops` is always `0`. # Actor input Schema ## `mode` (type: `string`): searchOneWay: cheapest one-way fares for a route; searchRoundTrip: cheapest return-trip combinations; exploreDestinations: all cheap fares from an airport (any destination); listAirports: all 220+ Ryanair airports. ## `origin` (type: `string`): 3-letter IATA airport code, e.g. STN, DUB, BCN. Required for searchOneWay, searchRoundTrip, and exploreDestinations. ## `destination` (type: `string`): 3-letter IATA airport code. Required for searchOneWay and searchRoundTrip. Leave empty for exploreDestinations. ## `departureDateFrom` (type: `string`): Earliest departure date to search. Defaults to tomorrow if not set. ## `departureDateTo` (type: `string`): Latest departure date to search. Defaults to 30 days from today if not set. ## `returnDateFrom` (type: `string`): Earliest return date for round trips. Defaults to departureDateFrom + 3 days. ## `returnDateTo` (type: `string`): Latest return date for round trips. Defaults to departureDateTo + 14 days. ## `adults` (type: `integer`): Number of adult passengers (1-9). ## `currency` (type: `string`): Currency for price display. ## `maxPrice` (type: `number`): Filter out fares above this price (in selected currency). Leave empty for no limit. ## `departureDaysOfWeek` (type: `array`): Filter fares to specific days of the week. Empty = all days. 1=Monday, 7=Sunday. ## `minTripDurationDays` (type: `integer`): Minimum number of nights for round-trip fares. ## `maxTripDurationDays` (type: `integer`): Maximum number of nights for round-trip fares. ## `maxItems` (type: `integer`): Maximum number of fare records to return. ## Actor input object example ```json { "mode": "exploreDestinations", "origin": "STN", "adults": 1, "currency": "EUR", "maxItems": 10 } ``` # Actor output Schema ## `flights` (type: `string`): Dataset containing all scraped Ryanair fare 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "exploreDestinations", "origin": "STN", "adults": 1, "currency": "EUR", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/ryanair-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "exploreDestinations", "origin": "STN", "adults": 1, "currency": "EUR", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/ryanair-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": "exploreDestinations", "origin": "STN", "adults": 1, "currency": "EUR", "maxItems": 10 }' | apify call crawlerbros/ryanair-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/ryanair-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ryanair Scraper", "description": "Search Ryanair's price calendar for the cheapest one-way and round-trip fares on any route. Explore all destinations from an airport to find the best deals. Returns real-time prices, flight numbers, departure/arrival times, and booking links.", "version": "1.0", "x-build-id": "VSscJ982BmgJrAMu6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ryanair-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ryanair-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/crawlerbros~ryanair-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ryanair-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/crawlerbros~ryanair-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ryanair-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", "properties": { "mode": { "title": "Search mode", "enum": [ "searchOneWay", "searchRoundTrip", "exploreDestinations", "listAirports" ], "type": "string", "description": "searchOneWay: cheapest one-way fares for a route; searchRoundTrip: cheapest return-trip combinations; exploreDestinations: all cheap fares from an airport (any destination); listAirports: all 220+ Ryanair airports.", "default": "searchOneWay" }, "origin": { "title": "Origin airport (IATA code)", "type": "string", "description": "3-letter IATA airport code, e.g. STN, DUB, BCN. Required for searchOneWay, searchRoundTrip, and exploreDestinations.", "default": "STN" }, "destination": { "title": "Destination airport (IATA code)", "type": "string", "description": "3-letter IATA airport code. Required for searchOneWay and searchRoundTrip. Leave empty for exploreDestinations." }, "departureDateFrom": { "title": "Departure date from (YYYY-MM-DD)", "type": "string", "description": "Earliest departure date to search. Defaults to tomorrow if not set." }, "departureDateTo": { "title": "Departure date to (YYYY-MM-DD)", "type": "string", "description": "Latest departure date to search. Defaults to 30 days from today if not set." }, "returnDateFrom": { "title": "Return date from (YYYY-MM-DD)", "type": "string", "description": "Earliest return date for round trips. Defaults to departureDateFrom + 3 days." }, "returnDateTo": { "title": "Return date to (YYYY-MM-DD)", "type": "string", "description": "Latest return date for round trips. Defaults to departureDateTo + 14 days." }, "adults": { "title": "Number of adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult passengers (1-9).", "default": 1 }, "currency": { "title": "Currency", "enum": [ "EUR", "GBP", "USD", "PLN", "CZK", "HUF", "RON", "SEK", "NOK", "DKK", "CHF", "BGN", "HRK", "ILS", "MAD", "MXN", "BRL", "ARS", "CLP", "COP", "PEN", "UYU", "CAD", "AUD", "NZD", "SGD", "THB" ], "type": "string", "description": "Currency for price display.", "default": "EUR" }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 99999, "type": "number", "description": "Filter out fares above this price (in selected currency). Leave empty for no limit." }, "departureDaysOfWeek": { "title": "Departure days of week", "type": "array", "description": "Filter fares to specific days of the week. Empty = all days. 1=Monday, 7=Sunday.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7" ], "enumTitles": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ] } }, "minTripDurationDays": { "title": "Minimum trip duration (days, round-trip only)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Minimum number of nights for round-trip fares." }, "maxTripDurationDays": { "title": "Maximum trip duration (days, round-trip only)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Maximum number of nights for round-trip fares." }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of fare records to return.", "default": 100 } } }, "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 } } } } } } } } } } ```