Flight Price Calendar

Flight Price Calendar answers one question: when is this route cheapest? It returns the lowest fare for every departure date over the next weeks or the whole year — Google's own date grid, as data — and flags the cheapest days. For round trips it returns the departure × return grid, so you also see whether leaving a day earlier or staying a night longer is cheaper.

$0.20 per 1,000 rows. No run fee, no search fee, no proxy fee. A full year of dates for one route is 365 rows — 7 cents.

What a run returns

One row per date:

Field	Example
date	2027-03-15
price / currency	92 / USD
isCheapest	true for the five cheapest days in the window
googleFlightsUrl	Opens that exact date on Google Flights
tripLength (round trips)	Nights of stay for this departure × return pair

Plus a summary row with cheapestDates — the five best days with their prices — and, if you want it, Google's priceLevel and the typical price band for the route.

How to use it

1. Enter origin, destination and a departure date to anchor the window.
2. Set calendarDays: 60 for the next two months, 365 for the year.
3. Click Start. You get one row per date, cheapest days flagged.

Round trip: add a return date. Google keeps your trip length flexible around it and returns the grid, so you get "leave Tuesday, come back Sunday — $80 less" as rows you can sort.

A whole route map at once

{
  "routes": [
    { "origin": "DPS", "destination": "SIN" },
    { "origin": "DPS", "destination": "BKK" },
    { "origin": "DPS", "destination": "KUL" }
  ],
  "calendarDays": 180
}

Three routes × 180 days = 540 rows = 11 cents. Because nothing is charged per search, sweeping fifty routes costs exactly fifty times the rows and not a cent more.

What it is good for

• Flexible travellers and fare-deal sites: publish "cheapest week to fly Bali–Singapore" from data instead of guesswork.
• Travel agencies: answer "when should I book" with the actual grid in front of the client.
• Pricing and revenue teams: a year of daily lows per route is a demand curve — school holidays, Eid, Christmas and the quiet weeks all show up.
• Trip planners and AI agents: the calendar is the fastest way to turn "sometime in March" into a concrete date.

Fields you can set

Input	What it does
calendarDays	Size of the window: 30, 60, 180, 365
returnDate	Switches to the departure × return grid
adults / children / infants	Up to 9 passengers, infants in seat or on lap
cabinClass	economy, premium economy, business, first
maxStops	Nonstop only, or up to one or two stops
currency / market	Price in any currency, from any country's point of sale
routes	A list of routes swept in one run

What it costs

One event, $0.0002 per row — $0.20 per 1,000, down to $0.10 on higher Store tiers. Searches, retries, residential proxy and run start are free; rows that fail are never charged. A year for one route: 7 cents. Ten routes, 60 days, every week for a month: 2,400 rows — 48 cents.

Notes and limits

Calendar prices are the lowest fare Google shows for that date at the moment of the run — they move during the day, so a daily schedule is worth more than one big sweep. A stay longer than about a month returns a thinner grid, because most airlines cap round-trip stays. If Google does not answer the calendar request, an error row says so instead of a silent gap, and it is not charged.

The Actor reads publicly displayed prices without logging in or collecting personal data. Google's terms restrict automated access, and the legality of scraping public data depends on your jurisdiction and use.

Need something else?

Want the grid in a different shape, or a sweep across a hundred routes? Open an issue on this Actor's page — answered the same day.

Need the full itinerary list, layovers, aircraft, CO₂ and booking options with seller prices? Use Google Flights Scraper. Watching a single route for a price drop? Flight Price Tracker.