@2bad/ryanair

Ryanair API

Unofficial TypeScript client for Ryanair's API that provides easy access to flights, fares, and airport information.

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'

// Find your nearest airport
const closest = await airports.getClosest()

// Check available flight dates
const dates = await flights.getDates('BER', 'DUB')

// Get cheapest fares for your trip
const deals = await fares.getCheapestPerDay('BER', 'DUB', '2024-02-01')

API Overview

Airports API

• Get active airports list
• Find nearest airports
• Discover available destinations
• View airport details
• Search flight routes

View Airports Documentation →

Fares API

• Find cheapest daily fares
• Compare prices across date ranges
• Discover best round-trip deals
• Search by currency preference

View Fares Documentation →

Flights API

• Check flight availability
• View flight schedules
• Search available dates
• Access flight details

View Flights Documentation →

Understanding IATA Codes

IATA codes are three-letter identifiers used in aviation for airports worldwide. For example:

• DUB - Dublin Airport
• BER - Berlin Brandenburg Airport
• STN - London Stansted Airport

Find the complete list on IATA's official website.

Disclaimer

This is an unofficial package and is not affiliated with Ryanair. Usage is subject to Ryanair's API terms and conditions.

Contributing

Contributions are welcome! Here's how you can help:

• Fork the repository
• Create a feature branch
• Submit a pull request

Please ensure your code passes all tests and follows our coding standards.

License

MIT © 2BAD

Need help? Open an issue or check our Postman collection.

Changelog

[7.1.2] - 2024-12-22

Fixed

• Updated debounce hook to work correctly with new versions of got
• Made FareType.fareClass optional to match API
• Added missing README to package (#72)

Changed

• Switched from prettier to biome for formatting
• Updated ESLint config to @2bad/axiom