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

  • POSTSearch
  • POSTCalendar
  • POSTExplore

Finance

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

Price Calendar

1 credit

Get daily price data for a route to find the cheapest travel dates.

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

Parameters

originstringrequired

Departure airport IATA code (e.g. "SFO", "JFK").

destinationstringrequired

Arrival airport IATA code (e.g. "LAX", "LHR").

departureDatestringrequired

Departure date in YYYY-MM-DD format.

returnDatestring

Return date in YYYY-MM-DD format.

cabinClassstring

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

adultsnumber

Number of adult passengers (1-9). Defaults to 1.

childrennumber

Number of child passengers (0-9). Defaults to 0.

infantsOnLapnumber

Number of lap infants (0-9). Defaults to 0.

infantsInSeatnumber

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

modestring

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

fieldsstring[]

Fields to include in response. Omit or pass ["*"] for all.

Response Schema

dataobject

Google Flights calendar result

originstring

Departure airport IATA code

destinationstring

Arrival airport IATA code

pricesobject[]

Array of date/price pairs

countnumber

Total number of price entries

metaobject

Request metadata

toolstring

Tool name (google-flights-calendar)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

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": "2026-06-01"
  }'

Response Example

{
  "data": {
    "origin": "SFO",
    "destination": "LAX",
    "prices": [
      {
        "date": "2026-06-01",
        "price": 89
      },
      {
        "date": "2026-06-02",
        "price": 102
      },
      {
        "date": "2026-06-03",
        "price": 76
      }
    ],
    "count": 3
  },
  "meta": {
    "tool": "google-flights-calendar",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}