# x402serps Image Search

> x402serps Image Search is a paid API for AI agents from x402serps.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-16).

Returns image search results (title, page URL, image URL, thumbnail, dimensions) for a single query, up to 20 results, paid per call in USDC via x402.

## Facts

- Endpoint: POST https://x402serps.com/api/v1/images?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-image-search-f8efb5dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H1gLFuzQeU4PQ1a0ojSSb

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 x402serps-image-search-f8efb5dd -d '<json body>'
```

Example prompt: Search for images of 'golden retriever puppies' and give me up to 15 results from the US, including the image URLs, thumbnail URLs, and page sources.

## When to prefer this

Choose this endpoint when you need structured image search results with metadata (URL, thumbnail, dimensions, source) for a single query, especially in an AI agent pipeline that pays per call in USDC. Prefer over web scraping or general search endpoints when you specifically need image URLs and thumbnails rather than text snippets. Best for single-query, low-latency image discovery where cost-per-call billing is acceptable.

## Known failure modes

- Missing or empty query returns an error
- num parameter out of 1-20 range may be rejected or clamped
- Invalid country code gl may return default results or an error
- Payment failure via x402 prevents the call from completing
- Query returns fewer results than requested if insufficient images exist
- Network timeout on upstream image search provider

## How this service works

x402serps: Image results (title, page url, imageUrl, thumbnail, size) for one query, up to 20

## Output

A JSON object containing the original query string, the provider name, and an array of up to 20 image result objects each with: position index, page URL, page title, image URL, thumbnail URL, image width, image height, and source domain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Query (alias: query)"
  },
  "gl": {
   "type": "string",
   "description": "Country code, e.g. us, gb"
  },
  "num": {
   "type": "number",
   "description": "Results 1-20, default 10"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "golden gate bridge",
  "results": [
   {
    "url": "https://example.com/ggb",
    "title": "Golden Gate Bridge",
    "width": 1600,
    "height": 900,
    "source": "example.com",
    "imageUrl": "https://example.com/ggb.jpg",
    "position": 1,
    "thumbnailUrl": "https://example.com/ggb_t.jpg"
   }
  ],
  "provider": "primary"
 }
}
```

## More

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