@2bad/ryanair

Ryanair API

Unofficial typescript client for the Ryanair API that allows you to easily retrieve information about airports, flights and prices.

✨ Features

• 🔥 No bullshit
• 📝 Strongly typed methods and results
• 🍪 Handles cookies and sessions automatically
• 🔍 Endpoint specific functions for convenience

Install

npm install @2bad/ryanair

Warning: This package is native ESM and no longer provides a CommonJS export. If your project uses CommonJS, you will have to convert to ESM or use the dynamic import() function. Please don't open issues for questions regarding CommonJS / ESM.

Usage

import { airports, fares, flights } from '@2bad/ryanair'

// Get information about the closest airport based on your IP address
const airport = await airports.getClosest()

// Get a list of available dates from a specific destination
const dates = await flights.getDates('BER', 'DUB')

// Or the cheapest one-way fares between two airports for a given start date
const cheapest = await fares.cheapestPerDay('BER', 'DUB', '2023-10-10')

API

• Airports
  • getActive()
  • getClosest()
  • getDestinations(code: IataCode)
  • getInfo(code: IataCode)
  • searchByPhrase(phrase: string, locale = 'en-gb')
  • searchByRoute(from: string, to = '', locale = 'en-gb')
• Fares
  • cheapestPerDay(from: IataCode, to: IataCode, startDate: StrDate, currency = 'EUR')
• Flights
  • getDates(from: IataCode, to: IataCode)
  • getAvailable(params: Partial)

Error handling

Each function throws an Error if the request to the API fails or the response is invalid. Make sure to handle them or use try-catch statement.

Disclaimer

Please note that this is not an official library and has no affiliation with Ryanair. The wrapper is based on publicly available API, terms of use and limitations of the Ryanair API apply.

Contributing

We welcome contributions! If you find a bug or want to request a new feature, please open an issue. If you want to submit a bug fix or new feature, please open a pull request.