Google Flights calendar

Request#

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

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": "2026-11-30",
    "return_date": "2026-12-05",
    "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).

{
  "departure_airport": "JFK",
  "arrival_airport": "LAX",
  "currency": "USD",
  "adults": 1,
  "trip_type": "round_trip",
  "wire_bytes": 98234,
  "elapsed_s": 1.12,
  "cheapest_price": 198,
  "coverage": "14/15",
  "prices": [
    {
      "departure_date": "2029-03-01",
      "return_date": "2029-03-06",
      "price": 245,
      "currency": "USD",
      "display_price": "$245",
      "is_priced": true
    },
    {
      "departure_date": "2029-03-02",
      "return_date": "2029-03-07",
      "price": 198,
      "currency": "USD",
      "display_price": "$198",
      "is_priced": true
    }
  ]
}

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 fieldsHide 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.

• wire_bytesinteger | nullrequired

  Size of Google's response, bytes; null when the grid was assembled from several searches.

• 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.

Try it#

1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? request access).
2. Copy the cURL example above and run it in a terminal.
3. Or open the interactive playground on api.scrapercompany.com, paste your key and pick this endpoint.