ryanair-fare-finder

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.

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