# Google Autocomplete: `POST /v1/google/autocomplete`

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

The suggestions Google's search box offers for `q`.

Each suggestion carries its `value`; the
default `chrome` client adds Google's `type` (`QUERY`, `NAVIGATION`)
and `relevance` score, and `gws-wiz` adds entity `title`, `description`
and `thumbnail`. Same request and response names as the standard SERP API `google_autocomplete`; also served at
`GET /api/v1/search?engine=google_autocomplete`. An empty answer is not
charged.

Request body (JSON):

- `q` (string; required; min length 1, max length 400): The partial query to complete.
- `client` (string; optional; default chrome; one of chrome, firefox, gws-wiz, psy-ab, safari, toolbar, youtube): Which Google suggest client's format to return: `chrome` (type + relevance), `firefox`, `safari`, `toolbar`, `psy-ab`/`gws-wiz` (entity title, description, thumbnail), or `youtube`.
- `cp` (integer | null; optional; min 0, max 400): Cursor position inside `q` (0 = start). Google completes the word at the cursor; omitted means the end of `q`.
- `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`).

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)
