Skip to content
Docs

Google Flights calendar

Google Flights calendar/date-grid pricing.

POST/v1/serp/google_flights_calendar
6 creditsTry itGoogle Flights API overview →

Similar to the standard SERP API google_flights_calendar. Returns cheapest prices across a date range for flexible-date comparison.

Request

POSThttps://api.scrapercompany.com/v1/serp/google_flights_calendar

Authenticate with your API key in the x-api-key header (see Authentication).

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Body

JSON object. Unknown fields are rejected with 422.

  • departurestringrequiredmin length 3, max length 3

    IATA departure airport code.

  • arrivalstringrequiredmin length 3, max length 3

    IATA arrival airport code.

  • departure_datestring (date)required

    Target outbound date (center of date range).

  • return_datestring (date) | null

    Target return date for round-trip. Omit for one-way.

  • adultsintegerdefault 1min 1, max 9

    Number of passengers.

  • currencystringdefault USD

    ISO 4217 code for the returned prices. Major currencies include AED, AUD, BRL, CAD, CHF, CNY, EUR, GBP, HKD, INR, JPY, KRW, MXN, NZD, SGD, USD; all 39 supported codes are listed in the enum.

    39 allowed values

    AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, QAR, RON, SAR, SEK, SGD, THB, TRY, TWD, USD, VND, ZAR

  • hlstringdefault en

    Language code.

  • glstringdefault us

    Market/country code.

    251 allowed values

    ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cu, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, ir, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mf, mg, mh, mk, ml, mm, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sy, sz, tc, td, tf, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, uk, um, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, xk, ye, yt, za, zm, zw

  • date_window_daysintegerdefault 7min 1, max 30

    Days before/after target date to include in grid.

Example request

curl -X POST "https://api.scrapercompany.com/v1/serp/google_flights_calendar" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "departure": "JFK",
    "arrival": "LAX",
    "departure_date": "2027-01-15",
    "return_date": "2027-01-20",
    "currency": "USD"
  }'

Response

200 — Date-grid pricing for flexible-date comparison. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response
{
  "departure_airport": "JFK",
  "arrival_airport": "LAX",
  "currency": "USD",
  "adults": 1,
  "trip_type": "round_trip",
  "elapsed_s": 1.12,
  "cheapest_price": 198,
  "coverage": "14/15",
  "prices": [
    {
      "departure_date": "2027-03-06",
      "return_date": "2027-03-11",
      "price": 245,
      "currency": "USD",
      "display_price": "$245",
      "is_priced": true
    },
    {
      "departure_date": "2027-03-07",
      "return_date": "2027-03-12",
      "price": 198,
      "currency": "USD",
      "display_price": "$198",
      "is_priced": true
    }
  ]
}
Arrays are shortened to their first items.

Response fields

Fields marked required are always present; others appear when they apply.

  • departure_airportstringrequired

    Echo of the request's departure.

  • arrival_airportstringrequired

    Echo of the request's arrival.

  • currencystringrequired
  • adultsintegerrequired
  • trip_typestringrequired

    One ofone_wayround_trip

  • pricesarray of objectrequired

    One row per date combination in the window.

    Show 6 child fields
    • prices[].departure_datestring (date)required
    • prices[].return_datestring (date)

      Present only for round trips.

    • prices[].pricenumber | nullrequired

      Cheapest fare Google shows for this date combination (whole trip), in currency; null when unpriced.

    • prices[].currencystringrequired
    • prices[].display_pricestring | nullrequired

      price with its currency symbol, e.g. $245.

    • prices[].is_pricedbooleanrequired

      price is not null.

  • elapsed_snumberrequired

    Seconds.

  • cheapest_pricenumber | nullrequired

    Lowest price in prices.

  • coveragestringrequired

    priced/total, e.g. 14/15 (a string here).

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

StatusMeaningRetry?
401Unauthorized

Missing or invalid API key.

{"detail":"missing or invalid API key"}
No, fix the request
402Payment Required

Not enough credits for this request: the account's credits mode is enforce (mode in GET /v1/billing) and the request costs more than the available credits. Nothing is run or charged.

{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}
No, fix the request
422Unprocessable Content

Request validation failed.

{"detail":[{"loc":["body","token"],"msg":"Field required","type":"missing"}]}
No, fix the request
429Too Many Requests

Too many requests: the key's requests-per-minute limit was exceeded, or (in enforce credits mode) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry.

{"detail":"rate limit 60/min exceeded"}
Yes, with backoff
502Bad Gateway

The upstream source failed, blocked the request or returned an unusable answer. Safe to retry later; failed requests are not charged.

{"detail":"RuntimeError"}
Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

  1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
  2. Copy the cURL example above and run it in a terminal.

Credits

6 credits per successful call. Failed, blocked and empty results are free.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support