# OpenWebNinja Realtime Image Search

> OpenWebNinja Realtime Image Search is a paid API for AI agents from x402.openwebninja.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Search the web for images in real-time with rich filtering options including size, type, color, file format, aspect ratio, and usage rights

## Facts

- Endpoint: GET https://x402.openwebninja.com/realtime-image-search/search
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openwebninja-realtime-image-search-f368aa89
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zb0R3qwEvTpAMPQF8UJfN

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 openwebninja-realtime-image-search-f368aa89
```

Example prompt: Search for up to 20 large PNG photos of mountain landscapes that are licensed for commercial use — safe search on, from the US region.

## When to prefer this

Use this endpoint when you need real-time web image search with granular filtering (size, color, type, file format, aspect ratio, usage rights) rather than a static image database. Ideal for agents that need to surface fresh, publicly available images on any topic with specific visual requirements or licensing constraints.

## Known failure modes

- Missing required 'query' parameter returns a validation error
- Invalid enum value for size/type/color/file_type/aspect_ratio/usage_rights returns schema error
- Limit outside 1-100 range returns validation error
- No results found for highly specific combined filters returns empty array
- Payment not resolved causes 402 response before results are returned

## How this service works

40+ public web-data, SERP, e-commerce, real-estate, finance and AI-search APIs, payable per call over x402 (USDC on Base, Polygon, Arbitrum). No account or API key required. Most endpoints $0.003; AI-model endpoints $0.005.

## Output

An array of image result objects each containing an ID, URL, rank, size label, title, pixel dimensions (width and height), and source information — up to 100 results per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

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