Documentation has been updated: see help center and changelog in one place.
Oxylabs dashboardContact us

Reverse Image Search

The google_images source is designed to retrieve Images search page for similar images to the one provided with a query parameter and websites containing those images.

Explore output data dictionary for each Reverse Image SERP feature, offering a brief description, screenshot, parsed JSON code snippet, and a table defining each parsed field. Navigate through the details using the right-side navigation or scrolling down the page.

Request samples

In this example, we make a request to retrieve a reverse image search results page for the image provided as the query value. We are also applying filters: results should come from the example.com domain, the file type should be html, and the result URLs should contain the image substring.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_images",
        "domain": "com",
        "query": "https://upload.wikimedia.org/wikipedia/commons/a/a3/June_odd-eyed-cat.jpg",
        "parse": true,
        "context": [
            {
                "key": "search_operators",
                "value": [
                    {"key": "site", "value": "example.com"},
                    {"key": "filetype", "value": "html"},
                    {"key": "inurl", "value": "image"}
                ],
                "callback_url": "https://your.callback.url"
            }
        ]
    }'

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Basic setup and customization options for scraping Google reverse image search results.

Parameter
Description
Default Value

source

Sets the scraper.

google_images

query

URL to image.

-

render

Enables JavaScript rendering when set to html. More info.

-

parse

Returns parsed data when set to true. Explore output data dictionary.

false

callback_url

URL to your callback endpoint. More info.

-

user_agent_type

Device type and browser. The full list can be found here.

desktop

- mandatory parameter

Localization

Adapt search results to specific geographical locations, domains, and languages.

Parameter
Description
Default Value

geo_location

The geographical location that the result should be adapted for. Using this parameter correctly is extremely important to get the right data. For more information, read about our suggested geo_location parameter structures here.

-

domain

Domain localization for Google. The full list of available domains can be found here.

com

locale

Accept-Language header value which changes your Google search page web interface language. More info.

-

context: results_language

Results language. List of supported Google languages can be found here.

-

Pagination

Controls for managing the pagination and retrieval of search results.

Parameter
Description
Default Value

start_page

Starting page number.

1

pages

Number of pages to retrieve.

1

Other

Additional advanced settings and controls for specialized requirements.

Parameter
Description
Default Value

context: nfpr

true will turn off spelling auto-correction

false

context: search_operators

Allows to incorporate advanced search parameters, such as site, inurl, etc., similar to those used in other Google search engines. Refer to the example to see how it can be applied with google_images.

-

Context parameters

All context parameters should be added to the context array as objects with key and value pairs, e.g.:

Structured data

google_images structured output

Output data dictionary

HTML example

JSON structure

The Google reverse image search structured output includes fields like URL, page, results, and others. The table below presents a detailed list of each SERP feature we parse, along with its description and data type. The table also includes some metadata.

The number of items and fields for a specific result type may vary depending on the search query.

Key
Description
Type

url

The URL of the Google search page.

string

results

A dictionary containing the results of the search.

array

results.organic

A list of unpaid image results with their respective details.

array

results.search_information

A list of details for the submitted search query.

object

results.total_results_count

The total number of results found for the search query.

integer

parse_status_code

The status code of the parsing job. You can see the parser status codes described here.

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

page

Page number relative to the Google SERP pagination.

integer

job_id

The ID of the job associated with the scraping job.

string

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

Organic

The reverse image search organic results are the unpaid listings on Google. Google's system picks them to match what people are looking for, and these listings appear below any ads.

Key (results.organic)
Description
Type

pos

An indicator denoting the position of a given item among organic results.

integer

url

The URL of the organic result.

string

desc

A short description of the organic result.

string

title

A short description of the organic result.

string

url_shown

The short-hand URL visible above the title.

string

Search information

search_information contains details about the reverse image search, including the original query that initiated the search. It provides information about the image used in the search, such as its URL, dimensions, and available sizes.

Key (results.search_information)
Description
Type

image

A list of details about the query image.

object

image.url

The URL of the search result.

string

image.width

The width of the image used for the search.

integer

image.height

The height of the image used for the search.

integer

image.other_sizes

A list of details about other possible search queries with other available image sizes.

array

image.other_sizes.url

The URL of the search result.

string

image.other_sizes.size

The size of the other available image.

string

query

The search query appearing next to the image selected for the reverse image search.

string

showing_results_for

The search term the search results are shown for. query and showing_results_for may differ if Google auto-corrected the provided search term

string

possible_related_search

Suggestion of other related search query provided by SERP.

string

PreviousLocal SearchNextGoogle Suggest

Last updated

Was this helpful?