Ryanair Fare finder
by @callum-kemp
Build and interpret Ryanair fare-finder URLs for cheap flight searches. Use when the user wants to find budget flights from a specific UK airport, configure...
clawhub install ryanair-fare-finderπ About This Skill
name: ryanair-fare-finder description: > Build and interpret Ryanair fare-finder URLs for cheap flight searches. Use when the user wants to find budget flights from a specific UK airport, configure departure/return time windows, set overnight or multi-night trip parameters, filter by day of week, or constrain results by price and currency. Handles all fare-finder query parameters including passenger counts, date ranges, flexible dates, and promo codes. compatibility: Requires network access to reach ryanair.com fare-finder pages. metadata: author: Callum Kemp version: "1.0" base-url: "https://www.ryanair.com/gb/en/fare-finder"
Ryanair Fare Finder
Generate, modify, and explain Ryanair fare-finder URLs from user requirements.
Base URL
https://www.ryanair.com/gb/en/fare-finder
All parameters below are appended as query-string key-value pairs.
Parameter Reference
Route
| Parameter | Type | Example | Description |
|----------------------|---------|---------|-----------------------------------------------------------------------------|
| originIata | string | MAN | IATA code of the departure airport (e.g. MAN, STN, LTN, EDI, BHX, LPL). |
| destinationIata | string | ANY | IATA code of the arrival airport, or ANY for all destinations. |
| isMacDestination | boolean | false | When true, filters to multi-airport city destinations only. |
Trip type
| Parameter | Type | Example | Description |
|-------------|---------|---------|------------------------------------------------------|
| isReturn | boolean | true | true for return (round-trip), false for one-way. |
Passengers
| Parameter | Type | Example | Description |
|-----------|------|---------|--------------------------|
| adults | int | 1 | Number of adults (16+). |
| teens | int | 0 | Number of teens (12-15). |
| children| int | 0 | Number of children (2-11).|
| infants | int | 0 | Number of infants (< 2). |
Date range
| Parameter | Type | Example | Description |
|---------------|---------|--------------|-----------------------------------------------------------------------------|
| dateOut | date | 2026-02-01 | Start of the search window (YYYY-MM-DD). |
| dateIn | date | 2027-01-31 | End of the search window (YYYY-MM-DD). |
| isExactDate | boolean | false | true to search a specific date only; false to scan the full date range. |
Day and flexibility
| Parameter | Type | Example | Description |
|------------------|---------|------------|--------------------------------------------------------------------|
| dayOfWeek | enum | SATURDAY | Restrict outbound to a specific day. Values: MONDAY..SUNDAY. |
| isFlexibleDay | boolean | false | When true, Ryanair widens the day-of-week filter by +/- 1 day. |
Stay duration
| Parameter | Type | Example | Description |
|--------------|------|---------|--------------------------------------------------------|
| daysTrip | int | 1 | Total trip length in days (outbound day counts as 1). |
| nightsFrom | int | 0 | Minimum number of nights at the destination. |
| nightsTo | int | 1 | Maximum number of nights at the destination. |
Time windows
| Parameter | Type | Example | Description |
|--------------------|--------|---------|--------------------------------------------------|
| outboundFromHour | string | 00:00 | Earliest acceptable outbound departure time. |
| outboundToHour | string | 11:00 | Latest acceptable outbound departure time. |
| inboundFromHour | string | 13:00 | Earliest acceptable return departure time. |
| inboundToHour | string | 23:59 | Latest acceptable return departure time. |
Pricing
| Parameter | Type | Example | Description |
|----------------|--------|---------|--------------------------------------------------------------------|
| currency | string | GBP | ISO 4217 currency code (GBP, EUR, etc.). |
| priceValueTo | int | 80 | Maximum total return price. Leave empty for no cap. |
| promoCode | string | *(empty)* | Ryanair promotional code, if applicable. |
Example: Overnight Saturday getaway from Manchester
The following URL searches for return flights from Manchester to anywhere, departing on a Saturday morning, returning the same day or next day in the afternoon/evening, across the full year, under GBP 80 return:
https://www.ryanair.com/gb/en/fare-finder?originIata=MAN&destinationIata=ANY&isReturn=true&isMacDestination=false&promoCode=&adults=1&teens=0&children=0&infants=0&dateOut=2026-02-01&dateIn=2027-01-31&daysTrip=1&nightsFrom=0&nightsTo=1&dayOfWeek=SATURDAY&isExactDate=false&outboundFromHour=00:00&outboundToHour=11:00&inboundFromHour=13:00&inboundToHour=23:59&priceValueTo=80¤cy=GBP&isFlexibleDay=false
Why these time windows work for overnights
Step-by-step: building a URL from scratch
1. Start with the base URL.
2. Set originIata to the user's departure airport IATA code.
3. Set destinationIata to a specific IATA code or ANY.
4. Choose isReturn=true for returns or false for one-way.
5. Set passenger counts (adults, teens, children, infants).
6. Define the date search window with dateOut and dateIn.
7. Pick dayOfWeek and set isExactDate=false to scan all matching days.
8. Configure stay duration with daysTrip, nightsFrom, nightsTo.
9. Set outbound/inbound time windows to taste.
10. Set currency and optionally priceValueTo for a price cap.
11. Add promoCode if the user has one.
Common UK origin airports
| IATA | Airport | |------|---------------------| | MAN | Manchester | | STN | London Stansted | | LTN | London Luton | | LGW | London Gatwick | | EDI | Edinburgh | | BHX | Birmingham | | LPL | Liverpool | | BRS | Bristol | | EMA | East Midlands | | GLA | Glasgow | | BFS | Belfast Intl | | LBA | Leeds Bradford | | NCL | Newcastle | | ABZ | Aberdeen |