Google Images results with original URLs and sizes

Request#

Authenticate with your API key in the x-api-key header (see Authentication).

Body#

JSON object. Unknown fields are rejected with 422.

• glstringdefault us

  Country market (Google gl): results are localized to this country.

  251 allowed values

  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

• hlstringdefault en

  Interface language (Google hl).

• locationstring | nullmin 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). Set gl to the place's country. Cannot be combined with uule.

• uulestring | nullmin 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.

• qstringrequiredmin length 1, max length 400

  Image search query (operators such as site: work).

• pageintegerdefault 1min 1, max 5

  Result page, 100 images per page. Later pages scroll the same render, so each costs more time.

• safestring | null

  SafeSearch: active filters explicit results, blur (Google's default) blurs them, off shows them.

  One ofactivebluroff

• sizestring | null

  Image size (Google tbs=isz:*).

  One oflargemediumicon

• colorstring | null

  Dominant color or black_and_white / transparent (Google tbs=ic:*).

  14 allowed values

  black_and_white, transparent, red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown

• image_typestring | null

  Image type (Google tbs=itp:*).

  One ofclipartline_drawinggiffacephoto

• time_periodstring | null

  Only results from the last hour/day/week/month/year (Google tbs=qdr:*).

  One oflast_hourlast_daylast_weeklast_monthlast_year

• usage_rightsstring | null

  License filter (Google tbs=sur:cl|ol).

  One ofcreative_commons_licensescommercial_or_other_licenses

• aspect_ratiostring | null

  Aspect ratio (Google tbs=iar:*).

  One ofsquaretallwidepanoramic

Example request#

curl -X POST "https://api.scrapercompany.com/v1/google/images" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "golden retriever"
  }'

Response#

200 — One rendered page of Google Images results with original URLs. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

{
  "search_parameters": {
    "engine": "google_images",
    "q": "golden retriever",
    "page": 1,
    "gl": "us",
    "hl": "en"
  },
  "images": [
    {
      "position": 1,
      "title": "Golden Retriever: Pros, Cons & Diet Guide | Ollie",
      "source": {
        "name": "Ollie Blog",
        "link": "https://blog.ollie.com/breed-deets-golden-retriever/"
      },
      "original": {
        "link": "https://blog.ollie.com/wp-content/uploads/250506_Livingroom_SHOT-10_0173_FR-scaled.jpg",
        "width": 2560,
        "height": 1707
      },
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSe1mLcW_M8xRI0J5UcnG6soPw9kd8XQOgz7Y4sOLFZoA&s=10",
      "domain": "blog.ollie.com",
      "image_id": "eYoKU9jW-eRT6M",
      "size": "522KB"
    },
    {
      "position": 2,
      "title": "Golden Retriever - Wikipedia",
      "source": {
        "name": "Wikipedia",
        "link": "https://en.wikipedia.org/wiki/Golden_Retriever"
      },
      "original": {
        "link": "https://upload.wikimedia.org/wikipedia/commons/b/bd/Golden_Retriever_Dukedestiny01_drvd.jpg",
        "width": 652,
        "height": 515
      },
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ_example&s=10",
      "domain": "en.wikipedia.org",
      "image_id": "Xb3mJ1kq0yZ9QM"
    }
  ],
  "suggestions": [
    {
      "title": "Puppy",
      "link": "https://www.google.com/search?q=golden+retriever+puppy&udm=2",
      "q": "golden retriever puppy"
    }
  ],
  "related_searches": [
    {
      "query": "baby golden retriever",
      "link": "https://www.google.com/search?udm=2&q=baby+golden+retriever"
    }
  ],
  "total": 2,
  "meta": {
    "source": "google_images",
    "wire_bytes": 2044224,
    "elapsed_s": 4.5,
    "rendered": true
  }
}

Errors#

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

Try it#

1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? request access).
2. Copy the cURL example above and run it in a terminal.
3. Or open the interactive playground on api.scrapercompany.com, paste your key and pick this endpoint.