SkillHub

ryanair-fare-finder

v1.0.0

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....

Sourced from ClawHub, Authored by Callum Kemp

Installation

Please help me install the skill `ryanair-fare-finder` from SkillHub official store. npx skills add Callum-Kemp/ryanair-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&currency=GBP&isFlexibleDay=false

Why these time windows work for overnights

  • Outbound 00:00-11:00 — arrive by early afternoon, giving a full day/evening at the destination.
  • Inbound 13:00-23:59 — depart after checkout / lunch the next day, home by late evening.

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