# Google search: `POST /v1/google/search`

Cost: 4 credits (4 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/google-search

One page of Google web results.

This call can take several seconds. The answer carries the organic
list, the People Also Ask questions (the
questions only: answers load on expansion and are not in the DOM), the
AI Overview text when Google generates one, and related searches.
`link` is Google's `/goto` redirect unless `resolve=true`, which follows
each one (one HTTP request per result). `location` (a canonical place
name such as `Austin,Texas,United States`) or a raw `uule` localizes the
results to a city; `gl` sets the country the results are for.

Request body (JSON):

- `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): Country market (Google `gl`). Results are localized to this country.
- `hl` (string; optional; default en): Interface language (Google `hl`).
- `location` (string | null; optional; min length 2, max length 200): City-level geo-targeting: a Google canonical place name such as `Austin,Texas,United States` (The standard SERP API `location`). Encoded into Google's `uule` (`w+` form), which localizes results to that city. Set `gl` to the place's country. Cannot be combined with `uule`.
- `uule` (string | null; optional; min length 10, max length 1024): Raw Google `uule` passthrough (`w+...` canonical-name or `a+...` coordinate form), for callers that already encode their own. A `w ` whose `+` was decoded to a space is accepted. Cannot be combined with `location`.
- `q` (string; required; min length 1, max length 400): Search query.
- `page` (integer; optional; default 1; min 1, max 10): Result page (10 results per page).
- `num` (integer; optional; default 10; min 1, max 20): Results per page.
- `resolve` (boolean; optional; default false): Follow each result's `/goto` redirect to the destination URL (one HTTP request per result).

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)
