Reverse-search a public image URL with Google Lens

POST/v1/tools/google.serp.lens/callsNeeds an API key

Returns the pages Google Lens matches to a public image. Use it to find where an image appears on the web.

Tool google.serp.lens on Google. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

image_urlstringRequired

Address of the public image to search with, starting with http:// or https://.

Format uri.

Matches ^https?://[^\s/?#]+\S*$.

countrystring· default us

Two-letter ISO 3166-1 country code. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`results`

A list of rows. Always present, possibly empty.

positioninteger

Rank among the matches, starting at 1.

titlestringRequired

Title of the page the matching image is on.

urlstringRequired

Address of the page the matching image is on.

sourcestring

Name of the site the matching image is on.

image_urlstring

Address of the matching image itself.

thumbnail_urlstring

Address of Google's reduced copy of the matching image.

curl https://api.voxoria.ai/v1/tools/google.serp.lens/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"image_url":"https://www.gstatic.com/webp/gallery/1.jpg"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.serp.lens/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {"image_url": "https://www.gstatic.com/webp/gallery/1.jpg"},
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google.serp.lens/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {"image_url": "https://www.gstatic.com/webp/gallery/1.jpg"},
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.serp.lens",
    "input": {
      "image_url": "https://www.gstatic.com/webp/gallery/1.jpg"
    }
  }
}

200 OKoutputapplication/json

{
  "results": [
    {
      "position": null,
      "title": "this is a post",
      "url": "https://www.instagram.com/p/DeHGGRunWk4/",
      "source": "Instagram",
      "image_url": "https://lookaside.instagram.com/seo/google_widget/crawler/?media_id=4001193613573581112",
      "thumbnail_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQjjpQNTPRkIfjfX5MCtTBCsgXmxhJnkT6j4JgmOc350GWltoUr"
    },
    {
      "position": null,
      "title": "Top 4 mountain hikes with fjord views | Visit Voss",
      "url": "https://www.visitvoss.no/en/4-fjellturar-med-fjordutsikt",
      "source": "Visit Voss",
      "image_url": "https://www.visitvoss.no/sites/cb_voss/files/inline-images/Breiskrednosi Espen Haagensen liten.jpg",
      "thumbnail_url": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTyCZRBFUAd_D7FTJgxwU1t3GLiDPVaWg_msJ2m6Vn4EC_FPTcL"
    },
    {
      "position": null,
      "title": "Voss Municipality: All You Must Know Before You Go (2026) - Tripadvisor",
      "url": "https://www.tripadvisor.com/Tourism-g616213-Voss_Municipality_Hordaland_Western_Norway-Vacations.html",
      "source": "Tripadvisor",
      "image_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/14/61/ed/b8/nordic-ventures.jpg?w=1100&h=-1&s=1",
      "thumbnail_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRuQbIaLK-i7fCvAgle8TAN73Jr_O9y-MSsS_SDksIjNcE3ne_M"
    }
  ]
}

The output of a real call, each list cut to 3 items.