# WebLens Image Search API

> WebLens Image Search API is a paid API for AI agents from api.weblens.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-12).

Searches the web for images matching a query and returns structured results including URLs, dimensions, thumbnails, and source pages

## Facts

- Endpoint: POST https://api.weblens.dev/search/images?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/weblens-image-search-api-7bb9a2c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_57Q9RjiD-_LOj9mDPE-LP

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 weblens-image-search-api-7bb9a2c6 -d '<json body>'
```

Example prompt: Search the web for images of the Golden Gate Bridge and give me the top results with their URLs, dimensions, and the pages they came from.

## When to prefer this

Choose this endpoint when you need structured image search results with metadata (dimensions, source pages, thumbnails) from across the web, especially when you need programmatic access to image assets rather than just a scraping or screenshot capability. Useful when you need multiple image results with attribution and sizing data in one call. The 70% cache discount makes repeat searches on common topics cost-effective.

## Known failure modes

- Query returns no results for very niche or restricted topics
- Rate limiting or payment failure via x402 protocol if USDC balance is insufficient
- Stale or broken image URLs if cached response is returned (cache is 70% cheaper but may be outdated)
- Malformed or missing query input returns a 400 error
- Upstream web search provider outage causes 502 or timeout

## How this service works

# WebLens - Web Intelligence API, pay per call

Scrape, crawl, map and extract the web. No account, no API key, no monthly
minimum — you pay for the calls you make and nothing else.

## Pricing
Page fetching starts at **$0.002**, whole-site crawling at
**$0.0015/page**, and sitemap discovery at **$0.004**.
Comparable services bill $0.007-0.008 per request, or reach a lower per-page
rate only on a $99/month commitment. WebLens has no commitment to reach.

## Payment Protocol
All paid endpoints use the [x402 protocol](https://x402.org) for HTTP-native
micropayments (USDC on Base).

## Cache Discount
Cached responses are **70% cheaper** than fresh fetches.

## Output

A JSON object containing the search query, a requestId, a searchedAt timestamp, and an array of image results — each with a title, width, height, imageUrl, thumbnail URL, source page URL, and position ranking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "maximum": 20,
   "description": "Max results (default 10, max 20)"
  },
  "query": {
   "type": "string",
   "description": "Search query"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "golden gate bridge",
  "results": [
   {
    "title": "Golden Gate Bridge",
    "width": 1920,
    "height": 1080,
    "imageUrl": "https://images.example.com/ggb.jpg",
    "position": 1,
    "thumbnail": "https://t.example.com/ggb.jpg",
    "sourcePage": "https://example.com/ggb"
   }
  ],
  "requestId": "req_img123",
  "searchedAt": "2026-07-25T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/weblens-image-search-api-7bb9a2c6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.weblens.dev](https://www.zero.xyz/host/api.weblens.dev/llms.txt)