# Avo Cado Read

> Avo Cado Read is a paid API for AI agents from avocado-read-api.a-347.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-01).

Fetches a public web page and returns its main content as clean Markdown, paying per call with USDC on Base via x402.

## Facts

- Endpoint: GET https://avocado-read-api.a-347.workers.dev/read?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/avo-cado-read-c790de04
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1iuoJfONFPm-WU0kmyO3L

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 avo-cado-read-c790de04
```

Example prompt: Can you read the page at https://en.wikipedia.org/wiki/Large_language_model and give me the main content as clean markdown?

## When to prefer this

Choose this endpoint when you need to fetch and clean a single public web page into Markdown without setting up accounts or API keys. It is ideal for AI pipelines that need readable page content for summarization, RAG ingestion, or analysis. The pay-per-call USDC model via x402 makes it suitable for agents that need lightweight, on-demand web reading without subscription overhead. It respects robots.txt, so it is a compliant choice for ethical web reading.

## Known failure modes

- Page is blocked by robots.txt — request is rejected and no charge is applied
- URL is unreachable or returns an HTTP error — fetch fails
- URL parameter missing or malformed — validation error returned
- Page requires JavaScript rendering that cannot be resolved server-side — content may be empty or partial
- Truncated flag set true if page content exceeds length limits

## How this service works

Web page to clean Markdown for AI agents. Pay per call with USDC on Base via x402: no accounts, no API keys. Respects robots.txt; you are not charged if the page cannot be fetched.

## Output

A JSON object containing the requested URL, final URL after redirects, page title, main content as clean Markdown, a list of links with text and href, language, byline, site name, excerpt, word count, fetch timestamp, and flags for whether the content was cached or truncated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri",
       "description": "Public http(s) URL of the page to read"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "url",
      "finalUrl",
      "title",
      "markdown",
      "links"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Requested URL"
      },
      "lang": {
       "type": [
        "string",
        "null"
       ]
      },
      "links": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "href": {
          "type": "string"
         },
         "text": {
          "type": "string"
         }
        }
       }
      },
      "title": {
       "type": "string"
      },
      "byline": {
       "type": [
        "string",
        "null"
       ]
      },
      "cached": {
       "type": "boolean"
      },
      "excerpt": {
       "type": [
        "string",
        "null"
       ]
      },
      "finalUrl": {
       "type": "string",
       "description": "URL after redirects"
      },
      "markdown": {
       "type": "string",
       "description": "Main content of the page as Markdown"
      },
      "siteName": {
       "type": [
        "string",
        "null"
       ]
      },
      "fetchedAt": {
       "type": "string",
       "format": "date-time"
      },
      "truncated": {
       "type": "boolean"
      },
      "wordCount": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://example.com",
  "lang": "en",
  "links": [
   {
    "href": "https://www.iana.org/domains/example",
    "text": "More information..."
   }
  ],
  "title": "Example Domain",
  "byline": null,
  "cached": false,
  "excerpt": "This domain is for use in illustrative examples in documents.",
  "finalUrl": "https://example.com/",
  "markdown": "This domain is for use in illustrative examples in documents. ...",
  "siteName": null,
  "fetchedAt": "2026-10-31T12:00:00.000Z",
  "truncated": false,
  "wordCount": 28
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/avo-cado-read-c790de04/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from avocado-read-api.a-347.workers.dev](https://www.zero.xyz/host/avocado-read-api.a-347.workers.dev/llms.txt)