Skip to content

New Official SDKs for TypeScript, Python and Go

SerpKite
Get API key

POST /v1/images

Google Images API

Image search results from Google with the original image URL, dimensions, thumbnail and the page it came from. Filter by SafeSearch and recency.

Get a free API key Try in playground
1 credit per page of results 2,500 free credits, no card Failed calls are free

Overview

What the Google Images API does

The Google Images API returns the Images tab as JSON. Each result includes the full-size image_url with image_width and image_height, a thumbnail_url, and the link and domain of the page that hosts the image.

Image rights belong to their owners. Use the source page to check licensing before you reuse an image; SerpKite returns links, it does not re-host images.

What you get

images[] array
position, title, image_url, image_width, image_height, thumbnail_url, source, domain, link.
request object
Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
meta object
request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.

Request

curl https://api.serpkite.com/v1/images \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"mid-century modern living room","country":"us"}'

Response (illustrative, placeholder domains)

200 OK · application/json
{
  "request": {
    "endpoint": "images",
    "engine": "google",
    "q": "mid-century modern living room",
    "country": "us",
    "language": "en",
    "page": 1
  },
  "results": [
    {
      "position": 1,
      "title": "Mid-century modern living room with walnut sideboard",
      "image_url": "https://interiors.example.com/uploads/mcm-living-room.jpg",
      "image_width": 1600,
      "image_height": 1067,
      "thumbnail_url": "https://thumbs.example.net/mcm-living-room-thumb.jpg",
      "source": "Example Interiors",
      "domain": "interiors.example.com",
      "link": "https://interiors.example.com/mid-century-living-rooms"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "engine": "google",
    "cached": false,
    "latency_ms": 812,
    "resolved_urls": true,
    "parse_quality": "ok"
  }
}

Every response also carries X-Credits-Used, X-Credits-Remaining, X-Cache and X-Tokens-Estimate headers. Run this query in the playground

Reference

Parameters

The parameters /v1/images accepts, in the JSON body or the query string.

Google Images API parameters
Name Type Default Description
q required string – The search query. Required. Up to 2,048 characters.
country string us Country to search from, as a two-letter ISO code (us, gb, de, in…).
language string en Interface language, as a language code (en, de, fr, pt-BR…).
num integer 10 Results per call. 10 per page; 100 fetches the top 100 as a depth bundle for 7 credits instead of 10. Values: 10, 20, 30, 50, 100.
page integer 1 Results page, 1–10. Each page is billed separately.
time string – Restrict to recent results. Shorthand for tbs=qdr:*. Values: hour, day, week, month, year.
safe string off SafeSearch filtering. Values: off, active.
format string json Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown.
fields string – Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
max_age integer – Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits.

Full reference, error codes and headers are in the API docs. Send a JSON array of up to 100 request objects to run them in one call.

Use cases

What people build with the Google Images API

01

Visual research

Collect reference images for design, moodboards or product ideas.

02

Dataset bootstrapping

Find candidate images and their source pages to review for a dataset.

03

Image SEO

See which pages rank in Google Images for your keywords.

04

Multimodal agents

Give a vision model real images to inspect, with the page they came from.

Pricing

Google Images API pricing

Cost per call

1 credit

per page of results

  • From $0.60 per 1,000 calls at volume.
  • Credits never expire. No subscription.
  • Failed, empty and blocked calls are refunded.
  • 2,500 free credits = 2,500 calls, then 1,000 credits a month.

For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.

See all pricing
Google Images API cost per pack
Pack Price Per 1k credits Per 1k calls Calls per pack
Starter $10 $1.00 $1.00 10,000
Growth $50 $0.80 $0.80 62,500
Pro $300 $0.60 $0.60 500,000

FAQ

Google Images API: common questions

Start building

Start with the Google Images API

2,500 free credits, then 1,000 every month. No credit card.