Google Lens API

The Google Lens API searches with a public image URL and returns structured JSON. Use it to find visually similar images, discover pages that contain the exact image, identify products and prices, or collect related search suggestions without rendering Google Lens yourself.

Key Features

• Visual matches: find pages with visually similar images and receive page, source, thumbnail, and full-size image details.
• Exact-image matches: use type=exact to find pages that contain the same image.
• Product data: receive prices, normalized price values, currencies, ratings, review counts, and stock status when Google shows them.
• Combined image and text search: add q to refine visual matches by color, model, product detail, or another keyword.
• Related searches: the default type=all response includes Google's suggested searches for the image when q is not sent.
• Localized results: control the interface language with hl and the result country, prices, and currencies with gl.

Endpoint

GET https://api.scrape.do/plugin/google/lens

Request Parameters

Required

Search

Localization

Output

Example Usage

Visual Matches and Related Searches

curl -G "https://api.scrape.do/plugin/google/lens" \
  --data-urlencode "token=$TOKEN" \
  --data-urlencode "url=https://m.media-amazon.com/images/I/61bK6PMOC3L._AC_SL1500_.jpg"

Refine an Image Search with Text

curl -G "https://api.scrape.do/plugin/google/lens" \
  --data-urlencode "token=$TOKEN" \
  --data-urlencode "url=https://m.media-amazon.com/images/I/61bK6PMOC3L._AC_SL1500_.jpg" \
  --data-urlencode "q=blue"

Exact-Image Matches

curl -G "https://api.scrape.do/plugin/google/lens" \
  --data-urlencode "token=$TOKEN" \
  --data-urlencode "url=https://m.media-amazon.com/images/I/61bK6PMOC3L._AC_SL1500_.jpg" \
  --data-urlencode "type=exact"

Response

Visual Results

Returned for type=all and type=visual. A typical search returns about 60 results.

{
  "search_parameters": {
    "image_url": "https://m.media-amazon.com/images/I/61bK6PMOC3L._AC_SL1500_.jpg",
    "type": "all",
    "hl": "en",
    "gl": "us"
  },
  "visual_results": [
    {
      "position": 1,
      "title": "Amazon.com: Apple iPhone 14, 128GB, Blue for T-Mobile ...",
      "link": "https://www.amazon.com/Apple-iPhone-128GB-T-Mobile-Renewed/dp/B0BN746959",
      "source": "Amazon.com",
      "domain": "www.amazon.com",
      "price": "$350*",
      "extracted_price": 350,
      "currency": "$",
      "rating": 4.3,
      "reviews": 2076,
      "in_stock": true,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:...",
      "image": {
        "link": "https://m.media-amazon.com/images/I/61aEBeER-+L._AC_UF894,1000_QL80_.jpg",
        "width": 755,
        "height": 1000
      }
    }
  ],
  "related_searches": [
    {
      "query": "Apple iPhone 14",
      "link": "https://www.google.com/search?q=Apple+iPhone+14&kgmid=/g/11s7qfcm0s&..."
    }
  ]
}

search_parameters

Shows the parameters used for the search: image_url, type, q, hl, gl, and safe. Optional q and safe fields appear only when sent. The response always includes the effective type, hl, and gl, including their defaults.

visual_results[]

When Google finds no visual match or cannot load the supplied image, the request can still succeed without a visual_results field.

related_searches[]

Returned only for type=all without q.

Exact Results

With type=exact, the response contains exact_results instead of visual_results and related_searches.

{
  "search_parameters": {
    "image_url": "https://m.media-amazon.com/images/I/61bK6PMOC3L._AC_SL1500_.jpg",
    "type": "exact",
    "hl": "en",
    "gl": "us"
  },
  "exact_results": [
    {
      "position": 1,
      "title": "Apple iPhone 14 A2649 Unlocked 256GB Blue Good - eBay",
      "link": "https://www.ebay.com/itm/...",
      "source": "eBay",
      "price": "$315.26",
      "extracted_price": 315.26,
      "currency": "$",
      "in_stock": true,
      "image_size": {
        "width": 756,
        "height": 1000
      }
    }
  ]
}

An image used widely returns up to 400 exact matches. If Google finds no page containing the exact image, the request can still succeed without an exact_results field.

HTML

When include_html=true, the response also includes html with the results page exactly as Google served it. This field is included even when the search finds no matches.

Links in html remain Google redirect URLs and are not replaced with the resolved links from exact_results. A typical results page is 0.7 to 1.3 MB and is usually smaller when no results match.

Usage Notes

• The image URL must be publicly reachable by Google. Hosts that block Google from fetching images can produce a successful response with no result array.
• type=all and type=visual usually complete in about 5 seconds.
• type=exact usually takes about 20 seconds and can take up to about 35 seconds because page links are resolved before the response is returned.
• Results come from one live search. Repeating the same request can return a different result set.
• q cannot be combined with type=exact.
• A two-letter code that is not a country, such as uk or en, is not rejected up front. The request fails with 502 after about a minute. Use ISO 3166-1 codes such as gb for the United Kingdom.

Error Handling