Google Images Search — API reference

POST

Available

/google/image/search

Google Images Search

Search Google Images by query for image results and source links. Returned links do not grant image usage rights.

type

images

result

images

Billing

1 credits

Search Google Images by query for image results and source links. Returned links do not grant image usage rights.

Parameters

FieldTypeAvailabilityDescription

q

required

string

required

Search query string.

hl

optional

string

optional

Language code. Defaults to en.

gl

optional

string

optional

Country code. Defaults to us.

page

optional

number

optional

1-based page number. Defaults to 1.

query

sample

string

Catalog sample; the API validates required fields.

sample: "red pandas"

json

{
  "query": "red pandas"
}

Open in Playground

Response fields

FieldTypeAvailabilityDescription

query

required

string

required

Normalized query from the request.

page

required

number

required

Current 1-based page number.

images

optional

ImageResult[]

When image results are parsed.

Google Images results.

ImageResult Result item schema

FieldTypeAvailabilityDescription

rank

required

number

required

1-based ranking position in this response.

position

optional

number

Alias for rank when available.

Normalized rank alias for clients that expect position.

title

optional

string

When image title or alt text is parsed.

Result title.

link

required

string

required

Primary link returned by the parser.

url

optional

string

Present for normalized result links.

Canonical target URL, usually the same value as link.

source_url

optional

string

Only when Google redirect/source URL is observed.

Original Google URL kept for debugging and provenance.

display_url

optional

string

When Google display text or a domain can be derived.

Display URL or source domain.

image_url

required

string

required

Full image URL.

thumbnail_url

optional

string

When Google exposes a thumbnail.

Thumbnail URL.

thumbnail

optional

string

Alias for thumbnail_url when available.

Normalized thumbnail alias.

source

optional

string

When source text is parsed.

Image source label.

domain

optional

string

When source page domain can be derived.

Source page domain.

Code and response examples

bash

curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'

Existing Google request example

bash

curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'

Notes

Visual search, product monitoring, image source discovery.

Some Google Images payload shapes expose rank/link but not every normalized alias. Treat url, display_url, source_url, position, and thumbnail as optional.