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.
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.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - 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)
{
"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.
| 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
Visual research
Collect reference images for design, moodboards or product ideas.
Dataset bootstrapping
Find candidate images and their source pages to review for a dataset.
Image SEO
See which pages rank in Google Images for your keywords.
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.
| 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
Keep exploring
Related APIs and integrations
Use it from
Start building
Start with the Google Images API
2,500 free credits, then 1,000 every month. No credit card.