Skip to content
SpideyData

Google Images

Google Images API

Search results for images—not your photo albums.

Google: live · not GA

Google's old Image Search API is deprecated, and the Photos Library API manages your own albums. If you want what Google Images shows for a query, this endpoint returns it as images[]: title, url, source_url, domain and alt.

images opening soon

Python · Google Images
r = requests.post("https://kieapi.com/v1/serp/google/images",
                  headers={"Authorization": f"Bearer {KEY}"},
                  json={"q": "mid-century chair", "country": "US"})
for img in r.json()["images"]:
    print(img["rank"], img["domain"], img["source_url"])

Which Google image API?

Google Photos Library API

Manages photos in your own Google Photos library. It does not search the web.

Photos Library API reference

Google Image Search API (old)

Deprecated; not an option for new projects.

Google Images SERP (this API)

Third-party: the Google Images results for a query, as images[] JSON.

images[] provenance fields

source_url

Use: The page the image appears on; may be null.

domain

Use: That page's domain; may be null.

encoded_url

Use: Returned as-is; may be null.

url, title, alt, subtitle

Use: The result link and its text; alt and subtitle may be null.

Launch status for this page

Check engine availability before choosing an endpoint. Google also supports News, Images and asynchronous tasks.

  • GoogleLiveGoogle is callable today with a Bearer API key.

SERP searches are charged per successful search at a display rate of 2 Credits per search; failed searches are not charged. Polling task status is free. The current rate is on Pricing.

What this is not

  • No image recognition or vision features.
  • No image file downloads.
  • No guidance on image licensing.

Frequently asked questions

Is this the Google Photos API?

No. It returns Google Images search results as images[].

What image fields exist?

rank, title, url, source_url, encoded_url, subtitle, alt and domain.

Does it download image files?

No. It returns fields only.

Google Images results as data

Get an API key and read images[] for any query.

images opening soon