# ReplyNodes — Web Data APIs for Agents (platform)

> ReplyNodes exposes read-only, normalized public web data to AI agents through one gateway: https://api.replynodes.com. Agents use prepaid credits with a bearer API key (`rn_live_...`) or pay per call in USDC on Base (x402 v2). Eight provider surfaces are live: X, Instagram, Reddit, Hacker News, App Store, YouTube, Google Play, and Fomo App.

## Main sections

- [Homepage](https://platform.replynodes.com/): product overview and provider surface list
- [Top up / Payment](https://platform.replynodes.com/payment): Base Mainnet USDC x402 onboarding that mints your API key after settlement
- [payment.json](https://platform.replynodes.com/payment.json): programmatic onboarding, top-up, and balance flows
- [skill.md](https://platform.replynodes.com/skill.md): full agent setup handbook (auth, payment, pagination, errors)
- [OpenAPI publication status](https://replynodes.com/api/openapi/): verified status; no OpenAPI document is published yet
- [MCP config](https://platform.replynodes.com/#mcp): remote MCP server setup (coming soon)

## Key facts

- Gateway base URL: `https://api.replynodes.com`
- Metered prices today: `GET /v1/x/users/{handle}/posts` = $0.05/call · `GET /v1/x/posts/{post_id}` = $0.01/call · all `/v1/appstore/*` and `/v1/youtube/*` ops = $0.003/call
- Google Play is priced in config ($0.003/call planned, matching App Store and YouTube) but not yet deployed — `/v1/googleplay/*` is not live
- Other provider surfaces (TikTok, Instagram, Reddit, Google News/Search/Maps/Shopping, Amazon, Hacker News, Product Hunt, Dev Intelligence, Shopify) are pre-launch — no prices yet
- Auth: `Authorization: Bearer rn_live_...` (prepaid credits) or x402 `X-PAYMENT` header (USDC on Base, network `eip155:8453`, scheme `exact`, x402 v2)
- Balance check (free): `GET https://api.replynodes.com/v1/me/balance`
- Route table + provider status (free): `GET https://api.replynodes.com/v1/x/capabilities`
- x402 discovery manifest: `https://api.replynodes.com/.well-known/x402.json`
- Debit is settle-before-delivery: failed requests are never charged; no refunds after successful delivery
- Web onboarding is Base Mainnet only and uses a short-lived, exact-amount x402 intent; no shared deposit address is used
- Rate limits are protective windows only (60/min per key, 300/min per org default); balance is the real backpressure — exhausted credits fail closed with HTTP 402 `topup_required`
- Lost keys cannot be recovered (only SHA-256 hashes stored); rotate instead
- Read-only guarantee: every operation is an HTTP GET against public data; no write path exists now or later
- MCP server at `https://api.replynodes.com/mcp` is coming soon (config published, not yet live); REST + x402 work today

## Quick start

```bash
# 1. onboard → https://platform.replynodes.com/payment (x402 payment mints rn_live_... key)
# 2. first call
curl https://api.replynodes.com/v1/x/users/naval/posts \
  -H "Authorization: Bearer rn_live_..."
# or pay per call without a key via x402: unauthenticated call returns
# 402 with exact payment requirements; retry with X-PAYMENT header.
```