Skip to main content
GET
Google Lens visual search

Authorizations

x-api-key
string
header
required

Query Parameters

url
string
required

Public URL of the image to search visually

query
string | null

Optional text refinement (e.g. 'pizza')

country
string | null

ISO country code (alias for gl)

language
string | null

Language code (alias for hl)

gl
string
default:us

Country code

hl
string
default:en

Language code

product
boolean
default:false

Only the tiles Google marked buyable (price + stock), drawn from the same grid

visual_matches
boolean
default:true

Always true in practice — false is reported back in warnings

exact_matches
boolean
default:false

Return only the pages hosting this image, flagged exact_match. Available for most images (8/10 in sampling); falls back to the full grid otherwise, saying so in warnings

Response

Successful Response

Response for GET /api/v1/lens/search.

image_url
string
required
lens_results
LensResult · object[]
results
LensResult · object[]