# Google Flights calendar: `POST /v1/serp/google_flights_calendar`

Cost: 6 credits (6 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/google-flights-calendar

Google Flights calendar/date-grid pricing.

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

Request body (JSON):

- `departure` (string; required; min length 3, max length 3): IATA departure airport code.
- `arrival` (string; required; min length 3, max length 3): IATA arrival airport code.
- `departure_date` (string (date); required): Target outbound date (center of date range).
- `return_date` (string (date) | null; optional): Target return date for round-trip. Omit for one-way.
- `adults` (integer; optional; default 1; min 1, max 9): Number of passengers.
- `currency` (string; optional; default USD; one of 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): 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.
- `hl` (string; optional; default en): Language code.
- `gl` (string; optional; default us; one of 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): Market/country code.
- `date_window_days` (integer; optional; default 7; min 1, max 30): Days before/after target date to include in grid.

Response fields:

- `departure_airport` (string; required): Echo of the request's `departure`.
- `arrival_airport` (string; required): Echo of the request's `arrival`.
- `currency` (string; required)
- `adults` (integer; required)
- `trip_type` (string; required; one of one_way, round_trip)
- `prices` (array of object; required): One row per date combination in the window.
  - `prices[].departure_date` (string (date); required)
  - `prices[].return_date` (string (date); optional): Present only for round trips.
  - `prices[].price` (number | null; required): Cheapest fare Google shows for this date combination (whole trip), in `currency`; null when unpriced.
  - `prices[].currency` (string; required)
  - `prices[].display_price` (string | null; required): `price` with its currency symbol, e.g. `$245`.
  - `prices[].is_priced` (boolean; required): `price` is not null.
- `elapsed_s` (number; required): Seconds.
- `cheapest_price` (number | null; required): Lowest `price` in `prices`.
- `coverage` (string; required): `priced/total`, e.g. `14/15` (a string here).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
