# Google Images: `POST /v1/google/images`

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

One page (up to 100) of Google Images results.

This call can take several seconds. Each image carries
the page `title`, the `source` page (`name`, `link`), the `original`
image (`link`, `width`, `height`) and Google's `thumbnail`, plus the
refinement `suggestions` and `related_searches` Google showed.
The standard SERP API filter names (`size`, `color`, `image_type`, `time_period`,
`usage_rights`, `aspect_ratio`, `safe`) map to Google's own `tbs`
codes; `location`/`uule` localize. Also served at
`GET /api/v1/search?engine=google_images`.

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): Image search query (operators such as `site:` work).
- `page` (integer; optional; default 1; min 1, max 5): Result page, 100 images per page. Later pages take longer.
- `safe` (string | null; optional; one of active, blur, off): SafeSearch: `active` filters explicit results, `blur` (Google's default) blurs them, `off` shows them.
- `size` (string | null; optional; one of large, medium, icon): Image size (Google `tbs=isz:*`).
- `color` (string | null; optional; one of black_and_white, transparent, red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown): Dominant color or `black_and_white` / `transparent` (Google `tbs=ic:*`).
- `image_type` (string | null; optional; one of clipart, line_drawing, gif, face, photo): Image type (Google `tbs=itp:*`).
- `time_period` (string | null; optional; one of last_hour, last_day, last_week, last_month, last_year): Only results from the last hour/day/week/month/year (Google `tbs=qdr:*`).
- `usage_rights` (string | null; optional; one of creative_commons_licenses, commercial_or_other_licenses): License filter (Google `tbs=sur:cl|ol`).
- `aspect_ratio` (string | null; optional; one of square, tall, wide, panoramic): Aspect ratio (Google `tbs=iar:*`).

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)
