# Reverse-search a public image URL with Google Lens

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.

## Example call

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

cURL:

```bash
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"}}'
```

Python:

```python
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())
```

TypeScript:

```ts
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());
```

MCP (`tools/call` params):

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

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `image_url` | string | Yes |  | Address of the public image to search with, starting with http:// or https://. Format `uri`. Matches `^https?://[^\s/?#]+\S*$`. |
| `country` | string | No | `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. |
| `language` | string | No | `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.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `position` | integer | No | Rank among the matches, starting at 1. |
| `title` | string | Yes | Title of the page the matching image is on. |
| `url` | string | Yes | Address of the page the matching image is on. |
| `source` | string | No | Name of the site the matching image is on. |
| `image_url` | string | No | Address of the matching image itself. |
| `thumbnail_url` | string | No | Address of Google's reduced copy of the matching image. |

## Example output

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

```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"
    }
  ]
}
```