# Ryanair Flight Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/ryanair/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/ryanair-search |

## Description

Search Ryanair routes by origin, destination, and date to get live fares, stops, duration, cabin classes, and seat counts as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/ryanair/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### MAD to BCN, round trip 20-27 Aug 2026

```json
{
  "search_info": {
    "origin": "MAD",
    "currency": "EUR",
    "destination": "BCN",
    "return_date": "2026-08-27",
    "total_results": 5,
    "departure_date": "2026-08-20"
  },
  "return_flights": [
    {
      "price": 19.99,
      "stops": 0,
      "taxes": 13.01,
      "origin": "BCN",
      "currency": "EUR",
      "flight_key": "BCN-MAD-20260827-FR8493",
      "booking_url": "https://www.ryanair.com/gb/en/booking/home/BCN/MAD/2026-08-27/null/1/0/0/0",
      "cabin_class": "value",
      "destination": "MAD",
      "total_price": 33,
      "arrival_time": "2026-08-27T09:50:00",
      "flight_number": "FR 8493",
      "departure_time": "2026-08-27T08:30:00",
      "seats_available": 7,
      "baggage_included": false,
      "duration_minutes": 80,
      "cabin_bag_included": false
    }
  ],
  "outbound_flights": [
    {
      "price": 14.99,
      "stops": 0,
      "taxes": 13.01,
      "origin": "MAD",
      "currency": "EUR",
      "flight_key": "MAD-BCN-20260820-FR8492",
      "booking_url": "https://www.ryanair.com/gb/en/booking/home/MAD/BCN/2026-08-20/2026-08-27/1/0/0/0",
      "cabin_class": "value",
      "destination": "BCN",
      "total_price": 28,
      "arrival_time": "2026-08-20T07:45:00",
      "flight_number": "FR 8492",
      "departure_time": "2026-08-20T06:25:00",
      "seats_available": 9,
      "baggage_included": false,
      "duration_minutes": 80,
      "cabin_bag_included": false
    },
    {
      "price": 24.99,
      "stops": 0,
      "taxes": 13.01,
      "origin": "MAD",
      "currency": "EUR",
      "flight_key": "MAD-BCN-20260820-FR8494",
      "booking_url": "https://www.ryanair.com/gb/en/booking/home/MAD/BCN/2026-08-20/2026-08-27/1/0/0/0",
      "cabin_class": "regular",
      "destination": "BCN",
      "total_price": 38,
      "arrival_time": "2026-08-20T11:30:00",
      "flight_number": "FR 8494",
      "departure_time": "2026-08-20T10:10:00",
      "seats_available": 4,
      "baggage_included": false,
      "duration_minutes": 80,
      "cabin_bag_included": true
    }
  ]
}
```

## Documentation

## Overview

Ryanair runs HUMAN Security (formerly PerimeterX) bot protection on its booking platform. Automated requests without the correct fingerprint are blocked. Piloterr handles the bypass and returns available flights, fares by tier, seat counts, and baggage policies as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/ryanair/search?origin=MAD&destination=BCN&departure_date=2026-08-20
```

## Main use cases

- Build a Ryanair fare calendar by querying multiple departure dates across a route
- Monitor price drops on key routes and trigger automated travel deal alerts
- Power a round-trip search engine that pairs outbound and return Ryanair fares
- Feed a corporate travel budgeting dashboard with live Ryanair route pricing
- Track seat availability to model demand patterns on high-traffic routes