scraper
Back to API docs

Overview

  • Overview

SERP

  • POSTSERP

Core

  • POSTGeocode
  • POSTTranslate
  • POSTSearch
  • POSTVision
  • POSTPlaces Search
  • POSTPlace Details
  • POSTPlaces Nearby
  • POSTAutocomplete

Maps

  • POSTSearch
  • POSTPlace Details
  • POSTReviews

Hotels

  • POSTSearch
  • POSTDetail
  • POSTReviews
  • POSTPhotos

Flights

  • POSTOne-way Search
  • POSTCalendar
  • POSTExplore

Finance

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTSearch
  • POSTEstimates
  • POSTEarnings

Price Calendar

1 credit

Compare live route prices across Graph, Grid, or round-trip Picker date windows.

POST/api/v1/tools/google-flights/calendar

Parameters

originstringrequired

Departure airport IATA code (for example, "SFO").

destinationstringrequired

Arrival airport IATA code (for example, "LAX").

departureDatestringrequired

Future departure date in YYYY-MM-DD format. Grid requires the full centered window to be non-past.

returnDatestring

Required for Picker and rejected for Graph/Grid. Must be after departureDate.

modestring

"graph", "grid", or "picker". Defaults to "graph".

calendarDaysnumber

Window size from 1 to 90. Defaults to 61 for Graph/Picker and 7 for Grid; Grid values must be odd.

cabinClassstring

"economy", "premium-economy", "business", or "first". Defaults to "economy".

currencystring

Currency used for returned prices. Defaults to "USD". Supported values: ALL, DZD, ARS, AMD, AWG, AUD, AZN, BSD, BHD, BYN, BMD, BAM, BRL, GBP, CAD, XPF, CLP, CNY, COP, CRC, CUP, CZK, DKK, DOP, EGP, EUR, GEL, HKD, HUF, ISK, INR, IDR, IRR, ILS, JMD, JPY, JOD, KZT, KWD, LBP, MKD, MYR, MXN, MDL, MAD, TWD, NZD, NGN, NOK, OMR, PKR, PAB, PEN, PHP, PLN, QAR, RON, RUB, SAR, RSD, SGD, ZAR, KRW, SEK, CHF, THB, TRY, UAH, AED, USD, VND.

adultsnumber

Number of adults (1-9). Defaults to 1; total passengers cannot exceed 9.

childrennumber

Number of children (0-9). Defaults to 0.

infantsOnLapnumber

Number of lap infants (0-9). Defaults to 0; each lap infant requires an adult.

infantsInSeatnumber

Number of infants in seats (0-9). Defaults to 0.

maxStopsnumber

Maximum stops: 0 (nonstop), 1, or 2.

maxPricenumber

Maximum total itinerary price as a positive whole amount in the requested currency.

maxDurationnumber

Maximum duration of each flight leg in minutes.

airlinesstring[]

Up to 20 airline IATA codes or ONEWORLD, STAR_ALLIANCE, and SKYTEAM.

departureTimeEarlieststring

Earliest local departure time (0-23 or HH:MM).

departureTimeLateststring

Latest local departure time (0-23 or HH:MM). A bound earlier than the earliest time selects an overnight range.

arrivalTimeEarlieststring

Earliest local arrival time (0-23 or HH:MM).

arrivalTimeLateststring

Latest local arrival time (0-23 or HH:MM). A bound earlier than the earliest time selects an overnight range.

fieldsstring[]

Top-level response fields to include. Omit or pass ["*"] for all.

Response Schema

dataobject

Calendar result

originstring

Departure airport IATA code

destinationstring

Arrival airport IATA code

currencystring

Requested price currency

pricesobject[]

Sorted, deduplicated date prices; empty when no dates match

countnumber

Number of priced dates or date pairs

metaobject

Request metadata

toolstring

google-flights-calendar

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

# Replace <GRID_CENTER_DATE> with a date whose full centered window is not in the past.
curl -X POST https://scraper.run/api/v1/tools/google-flights/calendar \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
  "origin": "SFO",
  "destination": "LAX",
  "departureDate": "<GRID_CENTER_DATE>",
  "mode": "grid",
  "calendarDays": 7,
  "currency": "USD"
}'

Response Example

{
  "data": {
    "origin": "SFO",
    "destination": "LAX",
    "currency": "USD",
    "prices": [
      {
        "date": "2026-09-23",
        "price": 33
      },
      {
        "date": "2026-09-24",
        "price": 23
      },
      {
        "date": "2026-09-25",
        "price": 59
      },
      {
        "date": "2026-09-26",
        "price": 46
      },
      {
        "date": "2026-09-27",
        "price": 49
      },
      {
        "date": "2026-09-28",
        "price": 59
      },
      {
        "date": "2026-09-29",
        "price": 33
      }
    ],
    "count": 7
  },
  "meta": {
    "tool": "google-flights-calendar",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}