# OpenVerbs Image Search API

> OpenVerbs Image Search API is a paid API for AI agents from search.openverbs.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-29).

Fetches live Google Images results for a query, returning ranked images with title, direct image URL, source page URL, and alt text, localised by location and language.

## Facts

- Endpoint: POST https://search.openverbs.com/v1/images?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openverbs-image-search-api-930d418f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_agXQkBzPqYGa0Bm3-SY26

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 openverbs-image-search-api-930d418f -d '<json body>'
```

Example prompt: Search Google Images for 'cherry blossom festival Tokyo' and give me the top 10 results with their image URLs and source pages, localised to Japan in Japanese.

## When to prefer this

Choose this endpoint when you need live, up-to-date Google Images results with localization support — especially when you need direct image URLs, source page context, and alt text together. Prefer this over static image databases or stock photo APIs when freshness and broad web coverage matter. Ideal when the agent needs to discover what images currently exist on the web for a topic, rather than generating or hosting images.

## Known failure modes

- Empty results if query is too niche or location-language combination returns no Google Images data
- Rate limiting or payment failure if x402 payment is not properly handled
- Invalid language code (must be 2-letter ISO) causes validation error
- Limit value out of range (must be 1–100) causes rejection
- Transient Google Images availability issues may return partial or empty result sets

## Output

An ordered list of image results, each containing: the image title, a direct URL to the image file, the URL of the source web page hosting the image, and the alt text describing the image. Results are ranked by Google's relevance scoring and filtered by the specified location and language.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 700,
   "minLength": 1,
   "description": "Search query."
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Depth / maximum results. Defaults to 10."
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$",
   "description": "Language code (2-letter). Defaults to en."
  },
  "location": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2,
   "description": "Location name, e.g. \"United States\" or \"London,England,United Kingdom\". Defaults to United States."
  }
 }
}
```

## More

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