Google Lens

SERP API Google Query Parameters

Configure Google search queries using Thordata’s SERP API, including localization parameters, seach type, and advanced parameter output options.

url ,Image URL(Required)

Parameter defines the URL of an image to perform the Google Lens search.

https://i.imgur.com/HBrB8p0.png

Example Request: Example using the parameter url: https://i.imgur.com/HBrB8p0.png

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1"

Localization

country ,Country(Optional)

Specify the target country/region for search results (default value: us). Use two-letter country codes(e.g., us, ru, uk).

For the complete list of supported country codes, please refer to: Google’s Country List.

Example Request:

Example results for q : pizza,country: ru

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "gl=ru" \
 -d "json=1"

hl ,Language(Optional)

Set the interface language for search results (default value: en). Adopt standard language code formats (e.g., en, es, zh-CN).

For the complete list of supported language codes, please refer to: Google Language Codes.

Example Request:

Example results forurl: https://i.imgur.com/HBrB8p0.png,hl: es

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1" \
 -d "hl=es"

Search Types

type ,Type of search(Optional)

The parameter defines the type of search to be performed. By default, the search type is all.

Available options:

all - All

products - Products

exact_matches - Exact Match

visual_matches - Visual Match.

Example Request:

Example results forurl: https://i.imgur.com/HBrB8p0.png,type: products

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1" \
 -d "type=products"

Advanced Parameters

q ,Search Query(Optional)

The parameter defines the search query to be used in Google Lens searches. Applicable only when type is set to all, products, visual_matches.

Example Request:

Example results forurl: https://i.imgur.com/HBrB8p0.png,q: acting

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1" \
 -d "q=acting" \
 -d "type=all"

safe ,Safe(Optional)

Filters adult content:

• safe=active – Strict filtering (default)

• safe=off – No filtering

Example Request:

Example results forurl: https://i.imgur.com/HBrB8p0.png,safe: active

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google" \
 -d "q=pizza" \
 -d "json=1" \
 -d "safe=active"

For further assistance, contact us at [email protected].