# VIVARIUM Web Fetch Service

> VIVARIUM Web Fetch Service is a paid API for AI agents from vivarium-gateway.masterfree818.workers.dev, paid per call via x402, $0.0055/call, status down (last checked 2026-10-13).

Fetches the content of a given URL and returns its text, title, and byte size, settled per-call in USDC on Base via x402.

## Facts

- Endpoint: POST https://vivarium-gateway.masterfree818.workers.dev/svc/fetch?utm_source=zero.xyz
- Price: $0.0055/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vivarium-web-fetch-service-1833e9c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R8zZdVAztnL1V1xlWlbLz

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 vivarium-web-fetch-service-1833e9c1 -d '<json body>'
```

Example prompt: Fetch the full text content of https://example.com/article and return up to 3000 characters of the page body along with its title.

## When to prefer this

Choose this endpoint when an AI agent needs on-demand, pay-per-call web page retrieval without managing browser infrastructure, proxies, or subscriptions. It is well-suited for agents that occasionally need to read a URL rather than crawl entire sites, and when micropayment-settled, trustless access (no API keys, no accounts) is preferred. Prefer alternatives if you need JavaScript rendering, bulk crawling, or structured data extraction.

## Known failure modes

- URL is unreachable or returns a non-200 HTTP status — ok: false with no content
- Payment settlement fails or USDC balance insufficient — request blocked before execution
- URL points to binary or non-text content — content may be empty or garbled
- max_chars set too low — content truncated aggressively, may lose meaningful data
- Rate limiting or bot protection on target site blocks the fetch

## How this service works

Pay-per-call machine services settled in USDC on Base via x402. No human in the loop; settlement is verified on-chain.

## Output

Returns a JSON object with a boolean 'ok' field, the echoed URL, total byte size of the fetched page, the page title, and the extracted text content (optionally truncated to max_chars). Suitable for downstream summarization, extraction, or monitoring tasks.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string"
  },
  "mode": {
   "type": "string"
  },
  "sample": {
   "type": "boolean"
  },
  "max_chars": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ok",
  "content"
 ],
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "url": {
   "type": "string"
  },
  "bytes": {
   "type": "integer"
  },
  "title": {
   "type": "string"
  },
  "content": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vivarium-web-fetch-service-1833e9c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vivarium-gateway.masterfree818.workers.dev](https://www.zero.xyz/host/vivarium-gateway.masterfree818.workers.dev/llms.txt)