# Agent Utility API

> Pay-per-call HTTP API for AI agents. Each call is metered and paid via the
> x402 protocol (USDC on Base mainnet) — no API key, account, or subscription
> required. Pay per request, get the response.

Base URL: https://agent-api-production-169b.up.railway.app

## Endpoints

- POST /v1/pdf/extract ($0.05): Structured PDF extraction (invoice, receipt,
  contract, form schemas). multipart/form-data body: `file` (the PDF),
  `doc_type` (auto|invoice|receipt|contract|form).
- GET /v1/kdp/lookup ($0.05): KDP/Amazon competitive market data — BSR,
  pricing, review counts, niche score. Query params: `category`, `keyword`,
  `asin` (at least one).
- POST /v1/transcribe/youtube ($0.10): YouTube video to structured transcript
  and timestamped summary. JSON body: `url`, `format`
  (summary|transcript|both), `background` (bool, for long videos).
- GET /v1/company/lookup ($0.01): Company enrichment — domain to name,
  description, logo, social profiles, and contact emails/phones. Query
  param: `domain` (bare domain or URL).
- GET /v1/profile/lookup ($0.05): X (Twitter) or LinkedIn public profile —
  name, bio/headline, location, followers, and for LinkedIn current company
  plus experience/education. Query params: `platform` (x|linkedin),
  `handle` (handle, public id, or profile URL).
- GET /v1/web/read ($0.02): Any webpage to clean, readable text —
  boilerplate stripped, ready for LLM context. Query param: `url`.
- GET /v1/email/verify ($0.01): Email verification — syntax, MX records,
  disposable-domain and role-account detection, graded
  valid/risky/invalid. Query param: `email`.
- GET /v1/crypto/price (FREE): Live crypto/FX prices from Chainlink
  oracles on Base: ETH, BTC, LINK, USDC, SOL, DOGE, AVAX, EUR (vs USD).
  Query param: `symbol`. Free sample of this API — the other 7 tools
  above are pay-per-call with no signup.

## Discovery

- Machine-readable route/price list: /.well-known/x402
- x402 Bazaar: routes declare bazaar discovery extensions (input/output
  JSON Schema) via the x402 Python SDK, cataloged automatically by the CDP
  facilitator on first settlement.
- Free (no payment) endpoints: /, /health, /.well-known/x402, /docs, this file.

## How to pay

Standard x402 flow: call any paid endpoint without payment, receive HTTP 402
with a `payment-required` header describing accepted payment options
(scheme "exact", network "eip155:8453" / Base mainnet, USDC). Sign and retry
with the `x-payment` header. Any x402-compatible HTTP client library handles
this automatically (e.g. the `x402` Python/TS SDKs).