Ryanair API: Get fare calendar
Gets the lowest one-way fare on each day of a month for a direct Ryanair route. For a city with several airports, it returns the airport pair with the lowest fare that month.
Unofficial. Not affiliated with or endorsed by Ryanair.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Month, required
month Month of departure, for example 2026-11 (YYYY-MM).
2026-11
Exactly 7 characters.
- Origin, required
origin Departure city or airport, for example London Stansted.
London
- Destination, required
destination Arrival city or airport, for example Barcelona.
Barcelona
Input as JSON
{ "month": "2026-11", "origin": "London", "destination": "Barcelona"}Output
{ "days": [ { "date": "2026-11-01", "page_link": "https://www.ryanair.com/gb/en/trip/flights/select?adults=1&dateOut=2026-11-01&originIata=STN&destinationIata=BCN&isReturn=false" , "cheapest_fare": 19.99, "flights_operate": "yes" }, { "date": "2026-11-02", "page_link": "https://www.ryanair.com/gb/en/trip/flights/select?adults=1&dateOut=2026-11-02&originIata=STN&destinationIata=BCN&isReturn=false" , "cheapest_fare": 19.99, "flights_operate": "yes" }, { "date": "2026-11-03", "page_link": "https://www.ryanair.com/gb/en/trip/flights/select?adults=1&dateOut=2026-11-03&originIata=STN&destinationIata=BCN&isReturn=false" , "cheapest_fare": 14.99, "flights_operate": "yes" } ], "cheapest_day": "2026-11-03", "cheapest_fare": 14.99, "currency_code": "GBP", "arrival_airport": "Barcelona", "departure_airport": "London Stansted", "arrival_airport_code": "BCN", "departure_airport_code": "STN"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ryanair.com/get_fare_calendar","input":{"month":"2026-11","origin":"London","destination":"Barcelona"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "ryanair.com/get_fare_calendar" , "input": { "month": "2026-11", "origin": "London", "destination": "Barcelona" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "ryanair.com/get_fare_calendar" , "input": { "month": "2026-11", "origin": "London", "destination": "Barcelona" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run ryanair.com/get_fare_calendar# with {"month":"2026-11","origin":"London","destination":"Barcelona"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "origin", "destination", "month" ], "properties": { "month": { "type": "string", "maxLength": 7, "minLength": 7, "description": "Month of departure, for example 2026-11 (YYYY-MM)." }, "origin": { "type": "string", "minLength": 1, "description": "Departure city or airport, for example London Stansted." }, "destination": { "type": "string", "minLength": 1, "description": "Arrival city or airport, for example Barcelona." } }}Output schema
{ "type": "object", "required": [ "departure_airport", "arrival_airport", "departure_airport_code", "arrival_airport_code", "currency_code", "days" ], "properties": { "days": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "page_link": { "type": "string" }, "cheapest_fare": { "type": [ "number", "null" ] }, "flights_operate": { "enum": [ "yes", "no" ], "type": "string" } } } }, "cheapest_day": { "type": [ "string", "null" ] }, "cheapest_fare": { "type": [ "number", "null" ] }, "currency_code": { "type": "string" }, "arrival_airport": { "type": "string" }, "departure_airport": { "type": "string" }, "arrival_airport_code": { "type": "string" }, "departure_airport_code": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ryanair.com/get_fare_calendar- Returns
- airports, currency, cheapest day and fare, daily fares with links
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method ryanair.com/get_fare_calendar with the inputs above.
Ask your agent
- What is the cheapest one-way flight from London Stansted to Barcelona on each day of November 2026?
- Show me the daily lowest fares for Dublin to Madrid across March 2027 and which day is cheapest.
- I'm flexible on dates in June 2026 — which day has the lowest one-way fare from Milan Bergamo to Lisbon?
- Can you compare the daily one-way prices from Krakow to Rome for 2026-09 and tell me the best day to fly?
- Find the airport pair with the lowest one-way fare from Berlin to Athens for April 2027, with links to each day's fare.
See more
All Ryanair methodsLists the cheapest one-way Ryanair fare to each destination from a city or airport during a date range, sorted by price.
ryanair.com/list_cheapest_faresFinds the lowest Google Flights fare for each departure date in a month between two places, for one-way trips or a fixed trip length, with the cheapest option and any price insight shown.
google.com/get_cheapest_datesLists cheap round-trip destinations from a city on Google Travel Explore, sorted by fare, optionally within a region, travel month, trip length and nonstop only. Links search Google Flights for the shown dates.
google.com/list_cheap_destinationsFinds priced flights between two cities or airports on Trip.com for the chosen dates, cheapest first; round trips pair each outbound flight with its available returns.
trip.com/search_flightsChecks a public Airbnb listing's calendar for one or more months: available nights per month and, for each day from today on, whether check-in and check-out are possible, the minimum stay, and the nightly price when Airbnb shows one.
airbnb.com/check_listing_availabilityFinds Expedia flights between cities or airports on selected dates, with per-traveler USD prices. Round trips combine outbound and return choices; for round trips only the cheapest outbound choices are paired with their returns.
expedia.com/search_flightsFinds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares.
google.com/search_flightsFinds dated FlixBus trip options between two cities, with stops, local times, availability and displayed per-person prices, including partner operators on some routes.
flixbus.com/search_bus_trips