# Agent Read Proxy – Link Extraction API (x402)

> Agent Read Proxy – Link Extraction API (x402) is a paid API for AI agents from agent-read-proxy.agent-read-proxy.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-16).

Extracts all hyperlinks (with anchor text and internal/external classification) from any public web page, returning structured JSON, paid per-call in USDC via x402.

## Facts

- Endpoint: GET https://agent-read-proxy.agent-read-proxy.workers.dev/v1/links?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-read-proxy-link-extraction-api-x402-c735d619
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zYxUfD-QzWj9nUoxttWwk

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 agent-read-proxy-link-extraction-api-x402-c735d619
```

Example prompt: Can you grab all the external links from https://en.wikipedia.org/wiki/Motocross and tell me where they point?

## When to prefer this

Choose this endpoint when you need a structured list of hyperlinks from a specific page — especially useful for SEO audits, site-mapping, link-graph analysis, or discovering related resources — without needing the full page text. It is simpler and cheaper than fetching full page content when only link data is required. Payment via x402/USDC on Base means no API key or account signup is needed.

## Known failure modes

- Invalid or non-public URL returns an error
- Page behind authentication or paywalls may return incomplete or empty link list
- Dynamically rendered JavaScript-heavy pages may yield fewer links than expected
- Network timeout if the target page is slow to respond
- Malformed URL in queryParams.url causes schema validation failure

## How this service works

Web scraping API for AI agents: turn any public web page into clean text or Markdown with title, author, date and language metadata. $0.002 per page, paid in USDC on Base via x402. No API key or signup.

## Output

Returns a JSON object containing the source page URL, total link count, the requested scope, and an array of link objects each with a URL, anchor text, and a boolean indicating whether the link is internal or external to the source domain.

## 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) web page"
      },
      "scope": {
       "enum": [
        "all",
        "internal",
        "external"
       ],
       "type": "string",
       "default": "all",
       "description": "Which links to return"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://en.wikipedia.org/wiki/Motocross",
  "count": 2,
  "links": [
   {
    "url": "https://www.fim-moto.com/",
    "text": "FIM",
    "internal": false
   }
  ],
  "scope": "external"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-read-proxy-link-extraction-api-x402-c735d619/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-read-proxy.agent-read-proxy.workers.dev](https://www.zero.xyz/host/agent-read-proxy.agent-read-proxy.workers.dev/llms.txt)
