# Image Search via Google Lens (OpenWeb Ninja)

> Image Search via Google Lens (OpenWeb Ninja) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Performs a reverse image search using a URL, returning visual matches, knowledge graph entities, and product results from the web.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-lens-data/search?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-image-search-via-google-lens-openweb-ninja-4d90f605
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uq1bbJzdoowjN6ZaqI919

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-image-search-via-google-lens-openweb-ninja-4d90f605
```

Example prompt: Can you do a reverse image search on this photo — https://i.imgur.com/HBrB8p0.png — and tell me what visually similar images, products, and knowledge graph info you find on the web?

## When to prefer this

Choose this endpoint when you need to reverse-image-search any publicly accessible image by URL and want visual matches, knowledge graph entity identification, and product/shopping results in a single call — especially when you want Google Lens quality results via a programmatic JSON API without browser automation.

## Known failure modes

- Invalid or inaccessible image URL returns an error or empty results
- Private or paywalled image URLs that cannot be fetched result in no matches
- Very low-quality or abstract images may return no visual matches or knowledge graph entries
- Invalid country or language codes may cause unexpected or empty results
- Rate limits or payment issues return 402 or 429 errors

## How this service works

Search image by url and get visual matches, knowledge graph, and products found on the web.  
  See it in action on - [Google Lens](https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fi.imgur.com%2FHBrB8p0.png).

## Output

Returns an object containing: an array of visual_matches (each with URL, title, image URL, thumbnail, source domain, ratings, reviews, and dimensions), a knowledge_graph array with entity cards when an identifiable subject is found, and an organic_results array with ranked web pages related to the image.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "URL of an image with which to perform the search."
  },
  "query": {
   "type": "string",
   "description": "Search query to further refine the results."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Set the country for the search (Google's gl parameter). Allowed values: 2-letter country code, see ISO 3166."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "Set the language of the results (Google's hl parameter). Allowed values: 2-letter language code, see ISO 639-1."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "visual_matches": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "link": {
        "type": "string",
        "description": "Canonical URL of the matched page."
       },
       "image": {
        "type": "string",
        "description": "Direct URL to the matched full-size image."
       },
       "title": {
        "type": "string",
        "description": "Title of the matched page."
       },
       "rating": {
        "type": "number",
        "nullable": true,
        "description": "Average rating of the matched product, when surfaced."
       },
       "source": {
        "type": "string",
        "description": "Domain of the source page."
       },
       "reviews": {
        "type": "integer",
        "nullable": true,
        "description": "Number of reviews of the matched product, when surfaced."
       },
       "position": {
        "type": "integer",
        "description": "1-based position of the match in the visual results list."
       },
       "thumbnail": {
        "type": "string",
        "description": "Google-hosted thumbnail URL for the matched image."
       },
       "image_width": {
        "type": "integer",
        "description": "Width of the matched image in pixels."
       },
       "source_icon": {
        "type": "string",
        "nullable": true,
        "description": "Favicon URL for the source."
       },
       "source_name": {
        "type": "string",
        "description": "Human-readable source name."
       },
       "image_height": {
        "type": "integer",
        "description": "Height of the matched image in pixels."
       },
       "thumbnail_width": {
        "type": "integer",
        "description": "Width of the thumbnail in pixels."
       },
       "thumbnail_height": {
        "type": "integer",
        "description": "Height of the thumbnail in pixels."
       }
      }
     },
     "description": "A list of visually similar matches found for the input image."
    },
    "knowledge_graph": {
     "type": "array",
     "items": {
      "type": "object"
     },
     "description": "Knowledge graph entities or cards returned for the visual search. Empty when no entity is identified."
    },
    "organic_results": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "url": {
        "type": "string",
        "description
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-image-search-via-google-lens-openweb-ninja-4d90f605/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)