# Munition Google Images Search

> Munition Google Images Search is a paid API for AI agents from api.munition.io, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-19).

Returns paid Google Images results (image URLs, thumbnails, dimensions, source pages) for a given query via Serper, billed at 0.004 USDC per call over x402.

## Facts

- Endpoint: POST https://api.munition.io/v1/serper/images?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/munition-google-images-search-3f98c1b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mPRVqv5JgiZrn-teTO1uS

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 munition-google-images-search-3f98c1b1 -d '<json body>'
```

Example prompt: Search Google Images for 'golden retriever puppies playing in snow' and give me 10 image URLs with their thumbnail links, dimensions, and source pages — use the US index in English.

## When to prefer this

Choose this endpoint when you need structured Google Images metadata (URLs, thumbnails, dimensions, source pages) programmatically for an AI agent workflow, especially when paying per-query in USDC via x402 is acceptable. Prefer this over general web search endpoints when visual content discovery is the primary goal. It is cheaper (0.004 USDC) than broader search endpoints on the same platform, making it cost-effective for high-volume image lookup tasks.

## Known failure modes

- Empty results for very niche or misspelled queries
- Rate limiting or payment failure via x402 protocol if USDC balance is insufficient
- Invalid country code or language code returns default or error response
- Page number beyond available results returns empty list
- Query exceeding 1000 characters rejected with validation error
- Serper upstream outage causes service unavailability

## How this service works

Munition Google Images: x402-paid Google Images results for AI agents via Serper. Pay 0.004 USDC per query for image URLs, thumbnails, dimensions and source pages.

## Output

Returns a list of Google Images results, each containing a direct image URL, a thumbnail URL, the image dimensions (width and height in pixels), and the URL of the source web page hosting the image. Results are paginated and scoped to the requested country and language.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 1000,
   "minLength": 1,
   "description": "Google query."
  },
  "gl": {
   "type": "string",
   "default": "us",
   "description": "Country code (gl), e.g. us, fr, de."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "description": "Interface language (hl), e.g. en, fr."
  },
  "num": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1
  },
  "tbs": {
   "type": "string",
   "description": "Time filter, e.g. qdr:d, qdr:w, qdr:m, qdr:y."
  },
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 10,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "searchedAt": "2026-09-09T00:00:00.000Z",
   "resultCount": 1
  },
  "query": "Eiffel tower at night",
  "images": [
   {
    "title": "Eiffel Tower",
    "source": "example.com",
    "imageUrl": "https://example.com/eiffel.jpg",
    "position": 1,
    "imageWidth": 1200,
    "imageHeight": 800
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/munition-google-images-search-3f98c1b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.munition.io](https://www.zero.xyz/host/api.munition.io/llms.txt)
