Lens
Our google_lens
source enables you to extract results from the Google Lens feature while performing an image search.
Query parameters
Parameter | Description | Default Value |
---|---|---|
source | Data source. More info. |
|
query | The URL of the image to be searched for. | - |
|
| - |
| 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 | - |
| Device type and browser. You can find the full list here. |
|
|
| - |
| Enables JavaScript rendering. More info. | - |
| URL to your callback endpoint. | - |
- required parameter
Code examples
The API sends a request to the Google Lens feature to retrieve structured data related to the content of an image.
The example above uses the Realtime integration method. If you would like to use some other integration method in your query (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.
Structured data
Data dictionary
JSON structure
This table outlines the key elements of a Google Lens search result. 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.
Key | Description | Type |
---|---|---|
| A dictionary containing the results of the search. | array |
| A list of unpaid image results with their respective details. | array |
| The total number of results found for the image URL. | integer |
| The status code of the parsing job. You can see the parser status codes described here. | integer |
| The timestamp when the scraping job was created. | timestamp |
| The timestamp when the scraping job was finished. | timestamp |
| Page number relative to the Google SERP pagination. | integer |
| The ID of the job associated with the scraping job. | string |
| The status code of the scraping job. You can see the scraper status codes described here. | integer |
Organic
Google Lens accounts multiple factors to deliver the most relevant and useful information to users based on the content of the image user uploads.
Key (results.organic) | Description | Type |
---|---|---|
| An indicator denoting the position of a given item among all Google Lens results. | integer |
| The URL of the Google Lens result. | string |
| The title of the result. | string |
| The source of the Google Lens result. | string |
| An indication of the position of the Google Lens result within the SERP. | integer |
| The base64-encoded thumbnail images of the Google Lens result. | string |
Last updated