# AgentUtil Documentation Semantic Search

> AgentUtil Documentation Semantic Search is a paid API for AI agents from docs.agentutil.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Searches pre-indexed developer documentation from 10+ platforms (Shopify, Stripe, Cloudflare, OpenAI, Anthropic, etc.) using a natural language query, returning ranked relevant content chunks with source URLs.

## Facts

- Endpoint: POST https://docs.agentutil.net/v1/query
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/docs-agentutil-net-aa1d2b62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_08Bcpzcqjwzw_GP5S0nWq

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 docs-agentutil-net-aa1d2b62 -d '<json body>'
```

Example prompt: Search the Stripe documentation for how to handle webhook signature verification — give me the top 5 most relevant chunks.

## When to prefer this

Use this endpoint when an AI agent needs to answer technical questions grounded in official developer documentation from major SaaS platforms (Stripe, Shopify, Cloudflare, OpenAI, Anthropic, etc.) rather than relying on training data. Prefer this over generic web search when the query is clearly scoped to a specific platform's API or SDK docs.

## Known failure modes

- Invalid or unsupported platform ID returns an error — use GET /platforms to discover valid options
- Query too vague returns low-relevance chunks with low relevance scores
- Platform ID not yet indexed returns empty results or 404
- max_chunks out of range (less than 1 or greater than 10) returns validation error
- Payment failure via x402 protocol returns 402 Payment Required

## How this service works

Search documentation by meaning. Ask a natural language question, get relevant chunks with source URLs from 10+ pre-indexed platforms (Shopify, Stripe, Cloudflare, OpenAI, Anthropic, etc).

## Output

An array of up to 10 documentation chunks, each containing the text content, source URL, page title, section heading, a relevance score (0-1), and a last-crawled timestamp. Also includes total match count, request ID, and related service suggestions.

## Example request

```json
{
 "query": "how to authenticate API requests",
 "platform": "filemaker",
 "max_chunks": 5
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "platform"
 ],
 "properties": {
  "query": {
   "type": "string",
   "description": "Natural language search query"
  },
  "category": {
   "type": "string",
   "description": "Optional category filter (e.g. graphql, rest, scripting)"
  },
  "platform": {
   "type": "string",
   "example": "filemaker",
   "description": "Platform ID to search documentation from. Must be a valid indexed platform (e.g. 'filemaker'). Use GET /platforms to discover available options."
  },
  "max_chunks": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Maximum number of result chunks to return (1–10, default 5)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "platform",
  "query",
  "results",
  "chunks_returned",
  "total_matches",
  "request_id",
  "service",
  "related_services"
 ],
 "properties": {
  "query": {
   "type": "string"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "content",
     "source_url",
     "page_title",
     "section",
     "relevance_score",
     "last_crawled"
    ],
    "properties": {
     "content": {
      "type": "string"
     },
     "section": {
      "type": "string"
     },
     "page_title": {
      "type": "string"
     },
     "source_url": {
      "type": "string"
     },
     "last_crawled": {
      "type": "string"
     },
     "relevance_score": {
      "type": "number"
     }
    }
   }
  },
  "service": {
   "type": "string"
  },
  "platform": {
   "type": "string"
  },
  "request_id": {
   "type": "string"
  },
  "total_matches": {
   "type": "number"
  },
  "chunks_returned": {
   "type": "number"
  },
  "related_services": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "url",
     "description"
    ],
    "properties": {
     "url": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "description": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/docs-agentutil-net-aa1d2b62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from docs.agentutil.net](https://www.zero.xyz/host/docs.agentutil.net/llms.txt)