# Ryanair Flight Fares Scraper \[Just 💰$0.18] (`blackfalcondata/ryanair-com-scraper`) Actor

Get Ryanair fares per day for a route like BER-MAD or from one airport: price and currency, departure and arrival times, sold-out flags and the booking link. Structured rows that load straight into fare tracking or a spreadsheet.

- **URL**: https://apify.com/blackfalcondata/ryanair-com-scraper.md
- **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community)
- **Categories:** Travel, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.18 / 1,000 results

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

### What does Ryanair Flight Fares Scraper do?

Ryanair Flight Fares Scraper extracts structured fare data from [ryanair.com](https://ryanair.com) — including prices. It supports keyword search, location filters, and controllable result limits, so you can run the same query consistently over time.

### How to use this actor

- 👉 **Register for a free Apify account** — no credit card required.
- 🎉 Just click **[Sign up free on Apify →](https://console.apify.com/sign-up?fpr=1h3gvi)** and complete a quick signup.
- 💰 A free Apify account includes $5 in monthly credits — enough to test this actor.
- ⏳ Scrape during the free trial, with no commitment or upfront payment required.

### Key features

- **📅 Day-by-day price calendar:** enter a route such as `BER-MAD` and get the cheapest fare for every day, up to 12 months ahead, with times, availability and a booking link. Sold-out and unavailable days are kept (or dropped with `includeUnavailable`), so the calendar has no gaps.
- **🔁 One way or round trip:** set `tripType` to `roundTrip` and each outbound day is paired with the cheapest return flight inside your return window that leaves after the outbound lands. The price is the total of both legs per person, with `outboundPrice`, `inboundPrice` and `tripDurationDays` alongside.
- **🕒 Every flight of the day:** `allFlights` lists each scheduled flight of a route and day with its number and times. Ryanair prices the day rather than each flight, so the cheapest flight carries the `price` and every row shows `dayCheapestPrice` and `isDayCheapest`.
- **🛫 Cheapest fares from an airport:** enter one airport such as `BER` to get the cheapest fare to every destination in your departure window, with the flight number and how the price moved (`previousPrice`, `priceChangePct`).
- **🎛️ Dates, currency, market and passengers:** exact days or windows for departure and return, any currency and site market, `maxPrice`, passenger counts (adults, teens, children, infants) and sorting by price, departure or duration. Fares are per person.
- **🔗 Paste-mode:** paste Ryanair flight-selection or fare-finder links into `startUrls`. The day, return day, passengers and site language in the link are kept for that search.
- **♻️ Incremental mode:** recurring runs return and charge only for fares that are new or whose price or availability changed. The first run builds the baseline; later runs return NEW, UPDATED and REAPPEARED fares, plus UNCHANGED ones when you turn on `emitUnchanged`. Fares that are no longer offered are remembered between runs but are not returned as records.
- **🔔 Notifications:** Telegram, Slack, Discord, WhatsApp Cloud API, and generic webhook out of the box. Pair with incremental for daily new-listing alerts without pipeline glue.
- **🔌 MCP connectors:** export your results into Notion via Apify's MCP connectors — a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows.
- **📌 Change classification:** in incremental mode each fare carries a `changeType` (NEW, UPDATED or UNCHANGED). Only new and changed fares are returned unless you turn on `emitUnchanged`.
- **🧹 Empty-field stripping:** drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards that already handle missing fields gracefully.

### What data can you extract from ryanair.com?

Each result includes Core fare fields (`listingId`, `listingKey`, `title`, `scrapeMode`, `tripType`, `type`, `direction`, and `route`, and more) and extended fields (`detailFetched`). In standard mode, all fields are always present — unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned.

### Input

The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema.

Key parameters:

- **`query`** — What to look up, as Ryanair airport codes (IATA, 3 letters). `BER-MAD` returns a day-by-day price calendar for that route (one month per page). A single code such as `BER` returns the cheapest fare to every destination from that airport. For several searches use a JSON array, e.g. `["BER-MAD","DUB-STN"]`.
- **`location`** — Route calendar (`BER-MAD`): the first month as `YYYY-MM`, e.g. `2026-11`; later pages continue month by month, up to 12 months ahead. Origin only (`BER`): a departure window `YYYY-MM-DD..YYYY-MM-DD`, e.g. `2026-11-01..2026-11-30`. Leave empty for the current month, or the next 30 days. The Depart From / Depart To fields below take precedence when set.
- **`market`** — Language and country of the Ryanair site, as `language-country`, e.g. `en-gb`, `de-de`, `es-es`. Default `en-gb`. It sets the booking links and the market the cheapest-fare list is requested for. (default: `"en-gb"`)
- **`maxResults`** — Maximum total results (0 = unlimited). (default: `100`)
- **`startUrls`** — Paste raw search URLs from the target site. Each URL becomes its own search task; results are merged and deduped by listing ID across all URLs. A pasted flight-selection link keeps its exact outbound day, its return day (round trip), passengers and the site language/country; a fare-finder link keeps its outbound and return windows. These override the matching fields above for that link only. When provided, startUrls REPLACE the query/location fields (each supported URL becomes one task; unsupported URLs are skipped, and if none is supported the run stops with an input error). (default: `[]`)
- **`tripType`** — One way (default) or round trip. A round trip on a route (`BER-MAD`) returns one row per outbound day, paired with the cheapest return flight inside the return window that leaves after the outbound lands; the price is the total of both legs per person. A round trip on an origin only (`BER`) returns Ryanair's cheapest return deals with both legs. (default: `"oneWay"`)
- **`departDateFrom`** — First outbound day, `YYYY-MM-DD`. Set it equal to Depart To for one exact day. Replaces the Date Range field when set.
- **`departDateTo`** — Last outbound day, `YYYY-MM-DD`. Leave empty to continue to the end of the booking window (a route calendar) or 30 days (an origin only).
- **`returnDateFrom`** — Round trips only: first return day, `YYYY-MM-DD`. Default: the first outbound day.
- **`returnDateTo`** — Round trips only: last return day, `YYYY-MM-DD`. Default: the last outbound day plus 7 days.
- **`allFlights`** — Route search, one way only: return a row for every scheduled flight of each day instead of only the day's cheapest. Ryanair prices the day, not each flight, so only the cheapest flight carries `price` (the other flights have `price: null`); every row shows `dayCheapestPrice` and `isDayCheapest`. Ignored (with a log warning) for round trips and for an origin-only search. (default: `false`)
- **`currency`** — Currency code the fares are quoted in, e.g. `EUR`, `GBP`, `USD`, `PLN`. Default `EUR`. Ryanair decides which currencies exist per route. (default: `"EUR"`)
- ...and 28 more parameters

### Input examples

**Basic search** — Keyword-driven search with a result cap.

→ Full payload per result — all standard fields populated where the source provides them.

```json
{
  "query": "BER-MAD",
  "maxResults": 50
}
```

**Incremental tracking** — Only emit fares that changed since the previous run with this `stateKey`.

→ First run builds the baseline state. Subsequent runs emit only records that are new or whose tracked content changed. Set `emitUnchanged: true` to include unchanged records as well.

```json
{
  "query": "BER-MAD",
  "maxResults": 200,
  "incrementalMode": true,
  "stateKey": "ber-mad-tracker"
}
```

**Compact output for AI agents** — Return only core fields for AI-agent and MCP workflows.

→ Small payload with the most important fields — ideal for piping into LLMs without token overhead.

```json
{
  "query": "BER-MAD",
  "maxResults": 50,
  "compact": true
}
```

### Output

Each run produces a dataset of structured fare records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

### Example fare record

```json
{
  "listingId": "328c22fd6ee8671111d322325f7c1b4c178ca458756edacf6283c68478b5225a",
  "listingKey": "BER-MAD-2026-10-01",
  "title": "Berlin Brandenburg → Madrid 2026-10-01",
  "scrapeMode": "routeCalendar",
  "tripType": "oneWay",
  "type": "calendar_day",
  "direction": "outbound",
  "route": "BER-MAD",
  "origin": "BER",
  "originName": "Berlin Brandenburg",
  "destination": "MAD",
  "destinationName": "Madrid",
  "location": "Madrid",
  "date": "2026-10-01",
  "outboundDate": "2026-10-01",
  "currency": "EUR",
  "available": false,
  "soldOut": false,
  "unavailable": true,
  "outbound": {
    "day": "2026-10-01",
    "soldOut": false,
    "unavailable": true
  },
  "bookingUrl": "https://www.ryanair.com/gb/en/trip/flights/select?adults=1&teens=0&children=0&infants=0&dateOut=2026-10-01&isConnectedFlight=false&isReturn=false&discount=0&promoCode=&originIata=BER&destinationIata=M...",
  "portalUrl": "https://www.ryanair.com/gb/en/trip/flights/select?adults=1&teens=0&children=0&infants=0&dateOut=2026-10-01&isConnectedFlight=false&isReturn=false&discount=0&promoCode=&originIata=BER&destinationIata=M...",
  "searchQuery": "BER-MAD",
  "contentQuality": "full",
  "detailFetched": false,
  "scrapedAt": "2026-10-22T10:05:44.434Z",
  "source": "ryanair.com",
  "contentHash": "0b22f9e4f23e70305a2ccee339caaec0f2794853d9428b10adeed0552482d474"
}
```

### Incremental fields

When incremental mode is on, each record also carries:

- `changeType` — one of `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`. Default output covers `NEW` / `UPDATED` / `REAPPEARED`; set `emitUnchanged: true` to opt into the others.
- `isRepost`, `repostOfId`, `repostDetectedAt` — populated when a new listing matches the tracked content of a previously expired one. Set `skipReposts: true` to drop detected reposts from the output.

### How to scrape ryanair.com

1. Go to [Ryanair Flight Fares Scraper](https://apify.com/blackfalcondata/ryanair-com-scraper?fpr=1h3gvi) in Apify Console.
2. Enter a search keyword and optional location filter.
3. Set `maxResults` to control how many results you need.
4. Click **Start** and wait for the run to finish.
5. Export the dataset as JSON, CSV, or Excel.

### Use cases

- Extract fare data from ryanair.com for market research and competitive analysis.
- Track pricing trends across regions and categories over time.
- Monitor new and changed fares on scheduled runs without processing the full dataset every time.
- Feed structured data into AI agents, MCP tools, and automated pipelines using compact mode.
- Export clean, structured data to dashboards, spreadsheets, or data warehouses.

### How much does it cost to scrape ryanair.com?

Ryanair Flight Fares Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced.

- **Run start:** $0.01 per run
- **Per result:** $0.00018 per fare record

Example costs:

- 10 results: **$0.012**
- 25 results: **$0.015**
- 100 results: **$0.028**
- 200 results: **$0.046**
- 500 results: **$0.1**

#### Example: recurring monitoring savings

These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of fares that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency — the scenarios below are examples, not predictions.

Example setup: 250 fares per run, daily polling (30 runs/month). Costs scale linearly with the number of fares.

| Churn rate | Full re-scrape run cost | Incremental run cost | Savings vs full re-scrape | Monthly cost after baseline |
|---|---:|---:|---:|---:|
| 5% — stable niche query | $0.06 | $0.01 | $0.04 (78%) | $0.37 |
| 15% — moderate broad query | $0.06 | $0.02 | $0.04 (70%) | $0.50 |
| 30% — high-volume aggregator | $0.06 | $0.02 | $0.03 (57%) | $0.70 |

Full re-scrape monthly cost at the same cadence: $1.65. First month with incremental costs $0.41 / $0.54 / $0.74 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply.

Platform usage is included in the per-result fee shown above.

### FAQ

#### How many results can I get from ryanair.com?

The number of results depends on the search query and available fares on ryanair.com. Use the `maxResults` parameter to control how many results are returned per run.

#### Does Ryanair Flight Fares Scraper support recurring monitoring?

Yes. Enable incremental mode to only receive new or changed fares on subsequent runs. This is ideal for scheduled monitoring where you want to track changes over time without re-processing the full dataset.

#### Can I integrate Ryanair Flight Fares Scraper with other apps?

Yes. Ryanair Flight Fares Scraper works with Apify's [integrations](https://apify.com/integrations?fpr=1h3gvi) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

#### Can I use Ryanair Flight Fares Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages.

#### Can I use Ryanair Flight Fares Scraper through an MCP Server?

Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server?fpr=1h3gvi) that lets AI assistants and agents call this actor directly. Use compact mode, a single `descriptionFormat`, and `excludeEmptyFields` to keep payloads manageable for LLM context windows.

#### Is it legal to scrape ryanair.com?

This actor extracts publicly available data from ryanair.com. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant.

#### Your feedback

If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/ryanair-com-scraper/issues?fpr=1h3gvi) on the actor's page in Apify Console. Your feedback helps us improve.

### You might also like

- [Agoda Reviews Scraper — Hotel Guest Reviews](https://apify.com/blackfalcondata/agoda-reviews-scraper?fpr=1h3gvi) — Scrape guest reviews for any Agoda hotel — star ratings · full review text in the original language.
- [Airbnb Realtime API — Live Listing, Reviews & Search Lookups](https://apify.com/blackfalcondata/airbnb-realtime?fpr=1h3gvi) — Real-time Airbnb lookups over HTTP: ask for one listing, its reviews or a location search and the.
- [Airbnb Reviews Scraper — vacation rental review data](https://apify.com/blackfalcondata/airbnb-reviews-scraper?fpr=1h3gvi) — Scrape airbnb.com reviews for any listing URL or a whole city. Get flat rows covering guest.
- [Airbnb Scraper — Listings, Prices & Host Data](https://apify.com/blackfalcondata/airbnb-scraper?fpr=1h3gvi) — Scrape Airbnb stays: price, ratings, amenities, host info, photos, GPS and full filters.
- [Booking Reviews Scraper \[Just 💰$1\] — by Hotel or Destination](https://apify.com/blackfalcondata/booking-reviews-scraper?fpr=1h3gvi) — 💰 $1 per 1,000 reviews. Scrape Booking.com guest reviews by hotel URL or destination. Each record.
- [easyJet Flight Fares Scraper — Daily Prices per Route](https://apify.com/blackfalcondata/easyjet-com-scraper?fpr=1h3gvi) — Get easyJet fares per flight for a route like LGW-CDG: flight number, departure and arrival times,.
- [Foursquare Scraper — Chain Locations by City](https://apify.com/blackfalcondata/foursquare-scraper?fpr=1h3gvi) — Scrape foursquare.com — locations of a chain in a city, with name, address, GPS coordinates,.
- [Google Flights Price Tracker 💰$0.52/1k](https://apify.com/blackfalcondata/google-flights-price-tracker?fpr=1h3gvi) — 💰 from $0.52/1k — Track Google Flights fares over time. Watch routes and get price-drop alerts via.

### Getting started with Apify

New to Apify? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=1h3gvi) — no credit card required.

1. Sign up — $5 platform credit included
2. Open this actor and configure your input
3. Click **Start** — export results as JSON, CSV, or Excel

Need more later? [See Apify pricing](https://apify.com/pricing?fpr=1h3gvi).

### Disclaimer

This actor accesses only publicly available data on ryanair.com. You are responsible for how you use the extracted data — in particular any personal information such as names, phone numbers, or email addresses — and for complying with Ryanair Flight Fares's terms of use, applicable data-protection law (including the GDPR where it applies), and the anti-spam rules of your jurisdiction.

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Ryanair Flight Fares or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

### Search keywords

ryanair scraper, ryanair api, apify ryanair, ryanair data extraction, ryanair flight fares scraper, ryanair flight fares api, apify ryanair flight fares, ryanair flight fares data extraction, ryanair.com scraper, ryanair.com data, ryanair.com api.

# Changelog

This Actor's version history is a separate document: https://apify.com/blackfalcondata/ryanair-com-scraper/changelog.md

# Actor input Schema

## `query` (type: `string`):

What to look up, as Ryanair airport codes (IATA, 3 letters). `BER-MAD` returns a day-by-day price calendar for that route (one month per page). A single code such as `BER` returns the cheapest fare to every destination from that airport. For several searches use a JSON array, e.g. `["BER-MAD","DUB-STN"]`.

## `location` (type: `string`):

Route calendar (`BER-MAD`): the first month as `YYYY-MM`, e.g. `2026-11`; later pages continue month by month, up to 12 months ahead. Origin only (`BER`): a departure window `YYYY-MM-DD..YYYY-MM-DD`, e.g. `2026-11-01..2026-11-30`. Leave empty for the current month, or the next 30 days. The Depart From / Depart To fields below take precedence when set.

## `market` (type: `string`):

Language and country of the Ryanair site, as `language-country`, e.g. `en-gb`, `de-de`, `es-es`. Default `en-gb`. It sets the booking links and the market the cheapest-fare list is requested for.

## `maxResults` (type: `integer`):

Maximum total results (0 = unlimited).

## `startUrls` (type: `array`):

Paste raw search URLs from the target site. Each URL becomes its own search task; results are merged and deduped by listing ID across all URLs. A pasted flight-selection link keeps its exact outbound day, its return day (round trip), passengers and the site language/country; a fare-finder link keeps its outbound and return windows. These override the matching fields above for that link only. When provided, startUrls REPLACE the query/location fields (each supported URL becomes one task; unsupported URLs are skipped, and if none is supported the run stops with an input error).

## `tripType` (type: `string`):

One way (default) or round trip. A round trip on a route (`BER-MAD`) returns one row per outbound day, paired with the cheapest return flight inside the return window that leaves after the outbound lands; the price is the total of both legs per person. A round trip on an origin only (`BER`) returns Ryanair's cheapest return deals with both legs.

## `departDateFrom` (type: `string`):

First outbound day, `YYYY-MM-DD`. Set it equal to Depart To for one exact day. Replaces the Date Range field when set.

## `departDateTo` (type: `string`):

Last outbound day, `YYYY-MM-DD`. Leave empty to continue to the end of the booking window (a route calendar) or 30 days (an origin only).

## `returnDateFrom` (type: `string`):

Round trips only: first return day, `YYYY-MM-DD`. Default: the first outbound day.

## `returnDateTo` (type: `string`):

Round trips only: last return day, `YYYY-MM-DD`. Default: the last outbound day plus 7 days.

## `allFlights` (type: `boolean`):

Route search, one way only: return a row for every scheduled flight of each day instead of only the day's cheapest. Ryanair prices the day, not each flight, so only the cheapest flight carries `price` (the other flights have `price: null`); every row shows `dayCheapestPrice` and `isDayCheapest`. Ignored (with a log warning) for round trips and for an origin-only search.

## `currency` (type: `string`):

Currency code the fares are quoted in, e.g. `EUR`, `GBP`, `USD`, `PLN`. Default `EUR`. Ryanair decides which currencies exist per route.

## `adults` (type: `integer`):

Passengers aged 16+. Default 1. Fares are always per person; this only sets the passenger counts on the result and in the booking link.

## `teens` (type: `integer`):

Passengers aged 12-15. Default 0.

## `children` (type: `integer`):

Passengers aged 2-11. Default 0.

## `infants` (type: `integer`):

Passengers under 2. Default 0.

## `maxPrice` (type: `number`):

Only return fares up to this price per person, in the chosen currency. For a round trip the total of both legs counts. Empty = no price limit. Days without a price are left out when this is set.

## `includeUnavailable` (type: `boolean`):

Keep days with no bookable fare (sold out or not flown), marked `available: false`, so a calendar has no gaps. Turn off to return bookable fares only.

## `sortBy` (type: `string`):

Order of the delivered results: Source order (as Ryanair serves them, streamed while scraping), Cheapest, Earliest departure or Shortest duration. A sorted run delivers its results at the end of the run instead of streaming them.

## `compact` (type: `boolean`):

Core fare fields only (for AI-agent/MCP workflows).

## `excludeEmptyFields` (type: `boolean`):

Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.

## `descriptionFormat` (type: `string`):

Choose which representation of the listing description to include. `all` keeps every variant; the others keep only the selected one.

## `incrementalMode` (type: `boolean`):

Compare against previous run state. stateKey is optional — defaults to a value derived from the search inputs (route or origin, dates, trip type, currency, market, passengers, price limit, startUrls) so different searches never share state. Sort By does not change it.

## `stateKey` (type: `string`):

Optional. Stable identifier for the tracked search universe. Leave empty to auto-generate from search inputs.

## `emitUnchanged` (type: `boolean`):

When Incremental Mode is on, also return fares whose price and availability have not changed since the previous run. Off by default: only new and changed fares are returned.

## `skipReposts` (type: `boolean`):

When incremental, skip listings whose content matches an expired listing from a prior run (cross-run duplicate detection).

## `notifyOnlyChanges` (type: `boolean`):

When Incremental Mode is on, only send notifications for NEW and UPDATED listings. Has no effect outside incremental mode.

## `notificationLimit` (type: `integer`):

Maximum number of listings included in each notification message (1–20).

## `telegramToken` (type: `string`):

Telegram bot token (from @BotFather). Required for Telegram notifications.

## `telegramChatId` (type: `string`):

Telegram chat or channel ID (e.g. "-100123456789"). Required when telegramToken is set.

## `discordWebhookUrl` (type: `string`):

Discord incoming webhook URL. Server Settings → Integrations → Webhooks → New Webhook.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook URL. api.slack.com/messaging/webhooks.

## `whatsappPhoneNumberId` (type: `string`):

Your WhatsApp Business phone-number ID (numeric, from Meta dashboard). Required when whatsappAccessToken is set.

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API permanent access token (System User token from Meta Business). Recipient must have messaged the business number within the last 24h (service-conversation window — free since Nov 2024).

## `whatsappTo` (type: `string`):

Recipient phone in E.164 format without + (e.g. "436641234567"). Recipient must have messaged your business number within last 24h.

## `webhookUrl` (type: `string`):

Receives a JSON POST with {metadata, items} after each run. Universal escape hatch for n8n / Make / Zapier / custom backends.

## `webhookHeaders` (type: `object`):

Optional JSON object of custom headers (e.g. {"Authorization":"Bearer ..."}).

## `appConnector` (type: `string`):

Optional. Pick a connected app under Settings → API & Integrations to receive your results (including any contact details). Best-effort across MCP connectors as Apify expands its catalog.

## `mcpIssueTeam` (type: `string`):

Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one.

## `maxPages` (type: `integer`):

Maximum result pages per search (0 = all, until Ryanair has no more). For a route calendar one page is one month, so 3 returns the next three months. Origin-only searches page through the destinations.

## Actor input object example

```json
{
  "query": "BER-MAD",
  "market": "en-gb",
  "maxResults": 100,
  "startUrls": [],
  "tripType": "oneWay",
  "allFlights": false,
  "currency": "EUR",
  "adults": 1,
  "teens": 0,
  "children": 0,
  "infants": 0,
  "includeUnavailable": true,
  "sortBy": "sourceOrder",
  "compact": false,
  "excludeEmptyFields": false,
  "descriptionFormat": "all",
  "incrementalMode": false,
  "emitUnchanged": false,
  "skipReposts": false,
  "notifyOnlyChanges": false,
  "notificationLimit": 5,
  "maxPages": 0
}
```

# Actor output Schema

## `results` (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 = {
    "query": "BER-MAD",
    "maxResults": 100,
    "excludeEmptyFields": false,
    "descriptionFormat": "all",
    "maxPages": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("blackfalcondata/ryanair-com-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "BER-MAD",
    "maxResults": 100,
    "excludeEmptyFields": False,
    "descriptionFormat": "all",
    "maxPages": 0,
}

# Run the Actor and wait for it to finish
run = client.actor("blackfalcondata/ryanair-com-scraper").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 '{
  "query": "BER-MAD",
  "maxResults": 100,
  "excludeEmptyFields": false,
  "descriptionFormat": "all",
  "maxPages": 0
}' |
apify call blackfalcondata/ryanair-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,blackfalcondata/ryanair-com-scraper"
        }
    }
}
```

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/kDB4HReUbW48N3TgH/builds/yje2mlRfcz4RdgxoU/openapi.json