# Flight location search: `POST /v1/serp/google_flights_location_search`

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

Google Flights' own autocomplete: airports, cities (with their
airports) and regions for a name. A city's `id` (`/m/...`) is accepted
as `departure`/`arrival` by `/v1/serp/google_flights`. ~0.1 s; repeated
queries are served from a 6-hour cache.

Request body (JSON):

- `q` (string; required; min length 1, max length 100): City, airport or region name, or a code (`paris`, `Heathrow`, `NYC`).
- `hl` (string; optional; default en; pattern ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$): Language of the returned names.
- `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 (two letters).

Response fields:

- `q` (string; required): Echo of the request's `q`.
- `locations` (array of object; required): Google's autocomplete results, in its order. An empty list is not billed.
  - `locations[].type` (string; required; one of airport, city, region, train_station)
  - `locations[].name` (string; required): e.g. `Paris, France`.
  - `locations[].iata` (string | null; required): IATA code of an airport or train station; null for cities and regions.
  - `locations[].id` (string | null; required): Google entity id, e.g. `/m/05qtj`. A city's id can be passed as `departure_id`/`arrival_id` (or a `multi_city` leg's `departure`/`arrival`) of `/v1/serp/google_flights` to search all of its airports.
  - `locations[].city` (string | null; required)
  - `locations[].description` (string | null; required): e.g. `Capital of France`, `Airport in France`.
  - `locations[].airports` (array of object; required): For a city: its airports and train stations. Empty otherwise.
- `count` (integer; required): Number of entries in `locations`.
- `elapsed_s` (number; required): Time Google took to answer, seconds; 0 when served from cache.
- `cached` (boolean; required): Served from the 6-hour cache of repeated queries.

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)
