# URL to Markdown Converter (x402)

> URL to Markdown Converter (x402) is a paid API for AI agents from x402-url-evidence.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches a public HTTP(S) webpage and returns its content converted to Markdown, paid via USDC on Base.

## Facts

- Endpoint: GET https://x402-url-evidence.vercel.app/api/markdown
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/url-to-markdown-converter-x402-d055aa91
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_emFt-XfuFXFW9Zslaf6Nb

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 url-to-markdown-converter-x402-d055aa91
```

Example prompt: Can you fetch the page at https://example.com/blog/intro and convert it to markdown so I can read the content cleanly?

## When to prefer this

Choose this endpoint when you need to fetch a live public webpage and get its content as clean, readable Markdown — ideal for feeding web content into LLMs, extracting documentation, or reading articles programmatically. Prefer this over raw HTML scraping when your downstream consumer needs plain text or structured markdown. It's well-suited for single-URL, on-demand page retrieval with micropayment billing at $0.01 USDC per call.

## Known failure modes

- Non-public or auth-gated URLs return an error or empty markdown
- Pages behind JavaScript rendering may not be fully captured
- Truncation flag set to true if content exceeds size limits
- Non-200 HTTP status from the target site propagated in the status field
- Invalid or malformed URLs cause a request error
- Payment failure via x402 prevents the call from completing

## How this service works

Paid deterministic utility APIs settled in native USDC on Base.

## Output

A JSON object containing the page title, HTTP status code, final (post-redirect) URL, the full page content as Markdown text, whether the content was truncated, character count, and original source byte size.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public HTTP(S) page to convert"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "title": "Example Domain",
  "status": 200,
  "finalUrl": "https://example.com/",
  "markdown": "# Example Domain",
  "truncated": false,
  "characters": 16,
  "sourceBytes": 1256
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/url-to-markdown-converter-x402-d055aa91/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-url-evidence.vercel.app](https://www.zero.xyz/host/x402-url-evidence.vercel.app/llms.txt)
