# AgentPay APIs

> Pay-per-call web, domain and document APIs for AI agents. No signup: pay per request with x402 (USDC on Algorand or Base) or with prepaid credits.

## Web Extract — Any URL to clean, LLM-ready markdown and structured metadata.

Fetches a web page and returns the main content as markdown, plus title, description, Open Graph metadata, canonical URL and all outbound links. Built for agents that need to read the web cheaply without running a browser.

- GET https://agentpay.agentpay-apis.workers.dev/extract/v1/page?url=https%3A%2F%2Fexample.com — Fetch a URL and return markdown, metadata and links. ($0.005 per call)
    - url (required): http(s) URL to read
    - maxChars: Max markdown characters (1000-200000, default 50000)

## Domain & Network Lookup — DNS, WHOIS/RDAP, IP ownership and one-call domain reports.

Authoritative-source lookups for agents doing research, lead qualification, security triage or ops: DNS records over HTTPS, registry WHOIS via RDAP, IP network ownership with reverse DNS, and a combined domain report (registration, DNS, email provider, SPF/DMARC, hosting).

- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/dns?name=example.com — Resolve DNS records (A, AAAA, CNAME, MX, NS, TXT, SOA, CAA, PTR, SRV). ($0.005 per call)
    - name (required): Hostname to resolve
    - type: Record type, default A
- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/whois?domain=example.com — Domain registration data (registrar, created/expires, status, nameservers) via RDAP. ($0.01 per call)
    - domain (required): Domain name
- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/ip?ip=1.1.1.1 — IP network owner, range, country and reverse DNS. ($0.01 per call)
    - ip (required): IPv4 or IPv6 address
- GET https://agentpay.agentpay-apis.workers.dev/lookup/v1/domain-report?domain=example.com — One-call domain report: registration, DNS, email provider, SPF/DMARC, hosting. ($0.02 per call)
    - domain (required): Domain name

## Doc Tools — PDF to text, RSS/Atom feeds to JSON, sitemaps to URL lists.

Document utilities agents otherwise have to install libraries for: extract per-page text from a PDF URL, normalize RSS/Atom/JSON feeds into JSON items, and crawl a site's sitemaps (via robots.txt) into a URL list.

- GET https://agentpay.agentpay-apis.workers.dev/tools/v1/pdf-text?url=https%3A%2F%2Fexample.com%2Ffile.pdf — Extract per-page text from a PDF URL (up to 20MB). ($0.01 per call)
    - url (required): URL of a PDF
- GET https://agentpay.agentpay-apis.workers.dev/tools/v1/feed?url=https%3A%2F%2Fhnrss.org%2Ffrontpage — Parse an RSS, Atom or JSON Feed into normalized JSON items. ($0.005 per call)
    - url (required): Feed URL
    - limit: Max items (default 50)
- GET https://agentpay.agentpay-apis.workers.dev/tools/v1/sitemap?url=https%3A%2F%2Fexample.com — List a site's URLs from its sitemaps (follows robots.txt and sitemap indexes). ($0.005 per call)
    - url (required): Site origin or sitemap URL
    - limit: Max URLs (default 5000)

## Payment

Standard x402 v2. Call an endpoint without payment to get HTTP 402 with a base64 PaymentRequired object in the PAYMENT-REQUIRED header, then retry with PAYMENT-SIGNATURE. Any x402 v2 client (e.g. @x402/fetch) works. Invalid input is rejected before payment, and payments are only settled if the call succeeds.

- USDC on Base (eip155:8453), exact scheme (EIP-3009), payTo 0x5d5d827D899CdcaCbD2b2e80162D805B3783C9D8. Settled via facilitator.
- USDC on Algorand (algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k), exact scheme, ASA 31566704, payTo F2ZYO2DDPQXOACUYBYQIHMQRAB3TJFZVCNUD3OU3CR5OOJUKFZOF5EYVJ4. Send a signed paymentGroup (client pays its own fee); settled directly by this server.

## Prepaid credits (cheapest for repeated use)

- Buy: GET https://agentpay.agentpay-apis.workers.dev/credits/buy?usd=5 — pay once via x402 on either network, receive {"apiKey"}. Any amount $1-$500; bonus credit +10% at $5+, +20% at $20+.
- Or send USDC on Algorand to F2ZYO2DDPQXOACUYBYQIHMQRAB3TJFZVCNUD3OU3CR5OOJUKFZOF5EYVJ4 with note `agentpay:<sha256 hex of a secret>`, then POST https://agentpay.agentpay-apis.workers.dev/credits/redeem {"txid","secret"}.
- Use: header `Authorization: Bearer <apiKey>`. Calls cost the Algorand price. Failed calls are refunded. Balance: GET https://agentpay.agentpay-apis.workers.dev/credits/balance.

## Integrations

- OpenAPI: https://agentpay.agentpay-apis.workers.dev/openapi.json
- MCP server (Streamable HTTP): https://agentpay.agentpay-apis.workers.dev/mcp — x402 via params._meta["x402/payment"], or header "Authorization: Bearer <apiKey>"
- x402 index: https://agentpay.agentpay-apis.workers.dev/.well-known/x402
- Docs and example clients: https://github.com/noah-silver/agentpay