# Tollmint Web Fetch & Analysis

> Tollmint Web Fetch & Analysis is a paid API for AI agents from api.tollmint.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-16).

Fetches a web page (or accepts raw HTML) and converts it to clean, truncatable markdown text with optional link preservation, billed per-call via x402 micropayment

## Facts

- Endpoint: POST https://api.tollmint.com/v1/web/fetch
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tollmint-web-fetch-analysis-0c86b814
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6GYhJzBclU84Wtlq_TBnq

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 tollmint-web-fetch-analysis-0c86b814 -d '<json body>'
```

Example prompt: Fetch the content of https://example.com/article and convert it to clean markdown — keep inline links, and cap it at 5000 words.

## When to prefer this

Choose this endpoint when an AI agent needs to fetch and read a web page's content programmatically without requiring a pre-registered account or API key — especially in autonomous, agentic workflows where the agent pays per-call via x402 USDC micropayment. It is ideal when you already have raw HTML you want converted to markdown, or when you want prose limited to a specific word count. Prefer it over browser automation tools when you only need text content, not JavaScript rendering or interactive sessions.

## Known failure modes

- URL is blocked by robots.txt — fetch is refused and an error is returned
- URL is unreachable or returns a non-200 status — network or HTTP error reported
- HTML payload exceeds the 2MB maxLength limit — request rejected
- max_words below minimum of 100 — validation error
- Payment not provided or insufficient — 402 response with price quote
- Malformed URL format — schema validation error

## How this service works

An API that quotes its own price and takes payment in the same request. Built for autonomous agents: no account, no invoice, no human in the loop.

## Output

A JSON response containing the page content rendered as clean markdown text, with prose truncated to the requested word limit if specified, a flag indicating whether truncation occurred, and optionally inline hyperlinks preserved in markdown format.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Page to analyse. Fetched respecting robots.txt."
  },
  "html": {
   "type": "string",
   "maxLength": 2000000,
   "description": "Raw HTML, if you already have it. Takes precedence over url."
  },
  "max_words": {
   "type": "integer",
   "maximum": 50000,
   "minimum": 100,
   "description": "Truncate the markdown at this many words. Truncation is reported."
  },
  "include_links": {
   "type": "boolean",
   "default": true,
   "description": "Keep inline links as markdown. Disable to cut tokens when only prose matters."
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tollmint-web-fetch-analysis-0c86b814/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tollmint.com](https://www.zero.xyz/host/api.tollmint.com/llms.txt)