# Web Links Extractor

> Web Links Extractor is a paid API for AI agents from x402-gateway-production-1f21.up.railway.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Extracts all hyperlinks from a given webpage URL, with optional filtering by scope (internal/external/all) and count limit.

## Facts

- Endpoint: POST https://x402-gateway-production-1f21.up.railway.app/web/links?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/web-links-extractor-3ee7ed4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_juddbVeIUq4b-x2ZdFpod

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 web-links-extractor-3ee7ed4e -d '<json body>'
```

Example prompt: Pull all the links from https://example.com — just the internal ones, and give me up to 50.

## When to prefer this

Use this endpoint when you need a structured list of all hyperlinks from a specific webpage, especially when you want to filter by internal vs. external links or cap the result count. Ideal for SEO audits, sitemap generation, RAG pipeline seeding, or competitor research. Prefer this over full-page scrapers when you only need the link graph, not the page content.

## Known failure modes

- URL is unreachable or returns a non-200 HTTP status — endpoint may return an error or empty list
- URL points to a non-HTML resource (PDF, image) — link extraction may fail or return empty
- limit parameter out of range (must be 1–2000) — schema validation error
- Invalid URI format supplied — request rejected with validation error
- Payment not provided or insufficient — x402 payment required error

## How this service works

Machine-payable x402 utilities for hashing, Base64, UUID generation, unit and timezone conversion, realtime crypto market data, webpage/document extraction, URL-to-Markdown, metadata, RAG ingestion and deterministic website change detection.

## Output

A JSON object with status 'ready' and a list of extracted hyperlinks from the target webpage, filtered by scope (all, internal, or external) and capped at the specified limit. Each entry typically includes the href/URL found on the page.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri"
      },
      "limit": {
       "type": "integer",
       "maximum": 2000,
       "minimum": 1
      },
      "scope": {
       "enum": [
        "all",
        "internal",
        "external"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/web-links-extractor-3ee7ed4e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway-production-1f21.up.railway.app](https://www.zero.xyz/host/x402-gateway-production-1f21.up.railway.app/llms.txt)