Google Reverse Image Search

Perform a reverse image search using Google Images. Useful for identifying image sources, verifying authenticity, tracking image usage across the web, and discovering visually similar images.

If you already know that you want to use Google Reverse Image Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.

At a Glance

Field	Value
Name	Google Reverse Image Search
Scraper	`google_reverse_image`
Engine	`google_reverse_image`
Website	Google
Website URL	googlereverseimage.com
Output Format	`json`
Version	`1.0.0`
Parameter Count	`11`
Parameter Groups	Localization (4), Advanced Filters (2), Geographic Location (2), Pagination (1), Request Controls (1), Advanced Parameters (1)

Request Example

This is the real request body used to validate google_reverse_image during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"google_reverse_image","image_url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"}'

Response Example

The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:19:38 UTC",
    "id": "01KMMKM8QE4TZ8YFFV9NKEJGVM",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKM8QE4TZ8YFFV9NKEJGVM.json",
    "processed_at": "2026-03-26 08:19:38 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKM8QE4TZ8YFFV9NKEJGVM.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "google_reverse_image",
    "image_url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
  },
  "total_credits_used": 1,
  "image_results": [
    {
      "displayed_link": "https://www.google.com",
      "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAA7VBMVEVHcE... [truncated data URL, 1046 chars]",
      "position": 1,
      "redirect_link": "https://www.google.com/",
      "snippet": "Search the world's information, including webpages, images, videos and more.Googlehas many special features to help you find exactly what you're looking ...",
      "source": "Google",
      "title": "Google"
    },
    {
      "_note": "6 more items omitted"
    }
  ],
  "image_sizes": [
    {
      "link": "https://www.google.com/search?sca_esv=3087728c2f704245&q=google&sa=X&ved=2ahUKEwia7ePbkL2TAxWkHkQIHXJxLZwQvQ56BAgJEAA",
      "title": "google"
    }
  ]
}

Required Parameters

If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.

Field	Type	Group	Description
`image_url`	`string`	Advanced Parameters	Image url.

Available Parameters

The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.

Localization

Field	Type	Required	Description
`gl`	`string`	No	Country or region code used to localize the results.
`hl`	`string`	No	Interface language used for the search and returned SERP labels.
`lr`	`string`	No	Limit results to one or more languages.
`google_domain`	`string`	No	Google domain to query, such as `google.com` or `google.co.uk`.

Additional Constraints

gl：Options: 244 options. Examples: af, al, dz, as, ad
hl：Options: 157 options. Examples: af, ak, sq, ws, am
google_domain：Options: 185 options. Examples: google.com, google.ad, google.ae, google.com.af, google.com.ag

Advanced Filters

Field	Type	Required	Description
`tbs`	`string`	No	Advanced Google filter string, often used for time or content filters.
`safe`	`string`	No	Safe-search level that controls adult-content filtering.

Additional Constraints

safe：Options: 2 options. Examples: active, off

Geographic Location

Field	Type	Required	Description
`uule`	`string`	No	Encoded Google location string for more precise geo-targeting.
`location`	`string`	No	Location hint used to make results closer to a target place.

Additional Constraints

location：Options: 10 options. Examples: India, United States, Brazil, Indonesia, Mexico

Pagination

Field	Type	Required	Description
`start`	`string`	No	Result offset used for Google-style pagination.

Request Controls

Field	Type	Required	Description
`no_cache`	`boolean`	No	Skip cached results and force a fresh fetch.

Additional Constraints

no_cache：Default: false

Advanced Parameters

Field	Type	Required	Description
`image_url`	`string`	Yes	Image url.

Engines

Google Reverse Image Search