Lens
Our google_lens
source enables you to extract results from the Google Lens feature while performing an image search.
Request samples
The API sends a request to the Google Lens feature to retrieve structured data related to the content of an image.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "google_lens",
"query": "https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg",
"parse": "true"
}'
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 Lens results.
source
Sets the scraper.
google_lens
query
The URL of the image to be searched for.
-
render
-
parse
false
callback_url
-
user_agent_type
desktop
- mandatory parameter
Localization
Adapt search results to specific geographical locations and languages.
geo_location
-
locale
-
Structured data
{
"results": [
{
"content": {
"results": {
"organic": [
{
"pos": 1,
"url": "https://www.pinterest.com/shopping/free-people-pink-maxi-dress/903333914404/",
"title": "Free People Pink Maxi Dress - Shop on Pinterest",
"domain": "Pinterest",
"pos_overall": 1,
"url_thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR5hGHj6ima-cDFEYeMNi-7ngOomqkHz_1Joc4_DVA5gDTprXGJ"
},
...
{
"pos": 59,
"url": "https://www.jjshouse.com/Sheath-Column-One-Shoulder-Floor-Length-Chiffon-Junior-Bridesmaid-Dress-With-Ruffle-Lace-Beading-009119572-g119572",
"title": "Sheath/Column One-Shoulder Floor-Length Chiffon Junior Bridesmaid Dress With Ruffle Lace Beading",
"domain": "JJsHouse.com",
"pos_overall": 59,
"url_thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR8evuMBA8z7Aa8mcYh97Y2hbpB3YIEV0ZSs2gkpYIyF3pmyj_X"
}
],
"total_results_count": 59
},
"parse_status_code": 12000
},
"created_at": "2024-03-13 15:07:42",
"updated_at": "2024-03-13 15:07:45",
"page": 1,
"url": "https://lens.google.com/uploadbyurl?url=https://www.beginningboutique.com.au/cdn/shop/files/Flossie-Pink-Maxi-Sleeveless-Dress_750x.jpg&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
"job_id": "7173696230097183745",
"status_code": 200,
"parser_type": ""
}
],
}
Output 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.
results
A dictionary containing the results of the search.
array
results.organic
A list of unpaid image results with their respective details.
array
total_results_count
The total number of results found for the image URL.
integer
parse_status_code
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
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.
...
{
"pos": 1,
"url": "https://www.pinterest.com/shopping/free-people-pink-maxi-dress/903333914404/",
"title": "Free People Pink Maxi Dress - Shop on Pinterest",
"domain": "Pinterest",
"pos_overall": 1,
"url_thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcR5hGHj6ima-cDFEYeMNi-7ngOomqkHz_1Joc4_DVA5gDTprXGJ"
},
...
pos
An indicator denoting the position of a given item among all Google Lens results.
integer
url
The URL of the Google Lens result.
string
title
The title of the result.
string
domain
The source of the Google Lens result.
string
pos_overall
An indication of the position of the Google Lens result within the SERP.
integer
url_thumbnail
The base64-encoded thumbnail images of the Google Lens result.
string
Last updated
Was this helpful?