Google Images
Google Images results as JSON: the original image URL, width and height, thumbnail, title, and the page and domain it was found on, by country and language.
Google Images results with the original image URL, dimensions, thumbnail and the page it was found on.
Request body
Send a JSON object with Content-Type: application/json. The same parameters also work
as a query string on GET /v1/images. JSON arrays are rejected: to run many queries at
once, use POST /v1/batches at half price. Unknown parameters
return 400 invalid_request with a message that names the replacement; see
strict validation.
| Parameter | 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…). Defaults to the country a location ends in. |
language | string | en | Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…). |
num | integer | 10 | Results per call, 1–100. Up to 10 returns one page of 10 (1 credit); above 10 on search and news fetches whole pages as a depth bundle, and 100 costs 7 credits instead of 10. On images a page holds up to 100 images and num (default all) is how many of them come back. |
page | integer | 1 | Results page, 1–10. Each page is billed separately. |
time | string | Restrict to recent results. Shorthand for tbs=qdr:*. One of: hour, day, week, month, year. |
|
tbs | string | Raw Google tbs filter, e.g. qdr:w2 or cdr:1,cd_min:1/1/2026,cd_max:1/31/2026. Overrides time. | |
safe | string | off | SafeSearch filtering. One of: off, active. |
format | string | json | Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. One of: 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. | |
engine | string or array | google | Which search providers may answer. google is Google only (SerpKite still retries Google internally); auto falls back to other providers when Google is blocked or times out; consensus (search only) asks several independent indexes in parallel, merges the results by URL, ranks them by agreement and lists each result's sources, at the sum of one page per provider that returned results; a provider name or a list (e.g. google,brave) restricts the request to those. meta.engine names the provider that answered. One of: google, auto, consensus, brave, bing, yahoo, duckduckgo, mojeek, wikipedia, yandex. |
include_domains | string[] | Only results from these sources, up to 20: a domain (example.com, subdomains match), a path prefix (github.com/org) or a TLD (.gov). Compiled to site: operators and enforced on the results. Search, news, images, videos. | |
exclude_domains | string[] | Drop results from these sources, up to 20, same formats as include_domains. Search, news, images, videos. | |
start_date | string | Only results published on or after this date (YYYY-MM-DD). Google's custom date range; can't be combined with time or tbs. | |
end_date | string | Only results published on or before this date (YYYY-MM-DD). |
Example request
Authenticate with Authorization: Bearer $SERPKITE_API_KEY (GET requests may pass
?api_key= instead). The official SDKs read
SERPKITE_API_KEY for you. See Authentication.
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 fields
| Field | Type | Description |
|---|---|---|
request | object | The normalised request, with defaults filled in: endpoint, engine, q, country, language, location, num, page, device, autocorrect… |
results[] | array | position, title, image_url, image_width, image_height, thumbnail_url, source, domain, link. |
meta | object | request_id, credits_used, cached, cached_at, engine (the provider that answered), route (provider attempts, see Search providers), latency_ms, parse_quality (ok, partial, empty), resolved_urls, unresolved_links (results whose link is still a Google redirect); llm (provider, model, input_tokens, output_tokens) and warnings when an AI step ran or failed. |
Every billed response also carries credit and latency headers
(X-Credits-Used, X-Credits-Remaining, X-Request-Id…).
Example response
{
"request": {
"endpoint": "images",
"engine": "google",
"q": "mid-century modern living room",
"country": "us",
"language": "en"
},
"results": [
{
"position": 1,
"title": "Mid-century modern living room ideas",
"image_url": "https://images.example.com/living-room.jpg",
"image_width": 1600,
"image_height": 1067,
"thumbnail_url": "https://images.example.com/living-room-thumb.jpg",
"source": "Example Interiors",
"domain": "interiors.example.com",
"link": "https://interiors.example.com/mid-century-living-room"
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"cached": false,
"engine": "google",
"latency_ms": 1034,
"parse_quality": "ok",
"resolved_urls": true
}
}Errors
Errors use one shape: {"error":{"code","message","request_id"}}. Errors are never billed.
Full list in Errors.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | A parameter is missing or invalid. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 402 | insufficient_credits | Your balance is too low. Buy a pack or wait for the monthly free grant. |
| 429 | rate_limited | Too many requests per second for your plan. Retry after the Retry-After header. |
| 503 | upstream_error | Google could not be fetched or parsed. Not billed; retry after Retry-After. |
Notes
- One page is a block of up to 100 images for 1 credit;
page: 2starts at position 101.num(1–100, default all) returns only the firstnumimages of the page, for the same credit. A page past the last one returns emptyresultsand is free. See Pagination and depth. safe: "active"enables SafeSearch.