# ReplyNodes developer docs

ReplyNodes is a read-only public-data gateway for agents and applications. The canonical REST host is api.replynodes.com; discover live data operations with https://api.replynodes.com/v1/capabilities. Provider operations are authenticated HTTP GETs; the keyless exceptions are listed below.

## Choose an integration

- **REST** — use the exact GET path and parameters from the API Reference, send `Authorization: Bearer ${REPLYNODES_API_KEY}`, and preserve the { data, meta } envelope.
- **MCP** — use the remote Streamable HTTP server at https://mcp.replynodes.com/mcp when your client supports MCP; interactive clients use native Better Auth MCP OAuth, and headless or manual setups fall back to a Bearer API key through the client secret mechanism.
- **SDK** — this repository contains OpenAPI Generator targets for TypeScript, Python, Go, Ruby, and PHP; verify each downstream package before installing it.
- **Agent integrations** — REST works with coding agents and tool functions; MCP-capable clients include Claude Code, Cursor, Codex, VS Code, Hermes, and OpenCode. ChatGPT uses a GPT Action/REST path rather than MCP.

## Authentication

ReplyNodes has two first-class authentication options: native Better Auth MCP OAuth at https://auth.replynodes.com for interactive MCP clients, and API keys for headless, manual, and REST use. Sign in at https://platform.replynodes.com/sign-in. For the agent claim flow, give the human the exact verification link, then store the returned key once as `REPLYNODES_API_KEY`; see https://replynodes.com/auth.md. Keep the key server-side and never put it in a URL, prompt, browser bundle, log, or commit.

## No key / With key

Only the following capabilities have keyless routes. At the daily limit the API returns `429 anonymous_limit_reached`; the claim flow at https://replynodes.com/auth.md gives an agent a key.

| Capability | Tier | Daily anonymous limit |
| --- | --- | ---: |
| brand-logo | Tier A | 20/day |
| app-store-api | Tier B | 10/day |
| google-play-api | Tier B | 10/day |
| reddit-api | Tier B | 10/day |
| youtube-api | Tier B | 10/day |
| web-search | Tier B | 10/day |
| web-scraping | Tier B | 10/day |
| company-research | Tier C | 3/day |
| competitor-research | Tier C | 3/day |

With a key, use the read-only provider GET/HEAD routes and the routes documented by the live capability contract.

## Live capability groups

- **Apple App Store (apps, ratings, reviews, search)**: 9 GETs; inspect the API Reference for the exact path and parameters.
- **Brand intelligence (retrieve, search, styleguide, fonts, logo)**: 6 GETs; inspect the API Reference for the exact path and parameters.
- **Google Play public app data**: 11 GETs; inspect the API Reference for the exact path and parameters.
- **Hacker News public stories, search, items, and users**: 9 GETs; inspect the API Reference for the exact path and parameters.
- **markdown**: 1 GET; inspect the API Reference for the exact path and parameters.
- **PDF to Markdown for AI agents (read PDF, extract PDF text, and PDF context)**: 1 GET, 1 HEAD, 1 POST; inspect the API Reference for the exact path and parameters.
- **Reddit public posts, search, subreddits, and users**: 6 GETs; inspect the API Reference for the exact path and parameters.
- **Anonymous research workflows (company and competitor dossiers)**: 2 GETs; inspect the API Reference for the exact path and parameters.
- **Web search**: 1 GET; inspect the API Reference for the exact path and parameters.
- **Web extraction (scrape, crawl/map, and page context)**: 4 GETs; inspect the API Reference for the exact path and parameters.
- **YouTube public videos, channels, comments, playlists, related videos, search, and transcripts**: 7 GETs; inspect the API Reference for the exact path and parameters.

## Start here

- [Agent Quickstart](https://docs.replynodes.com/docs/agent-quickstart) · [Markdown](https://docs.replynodes.com/docs/agent-quickstart.md)
- [Quickstart](https://docs.replynodes.com/docs/quickstart) · [Markdown](https://docs.replynodes.com/docs/quickstart.md)
- [Authentication](https://docs.replynodes.com/docs/auth) · [Markdown](https://docs.replynodes.com/docs/auth.md)
- [MCP setup](https://docs.replynodes.com/docs/mcp) · [Markdown](https://docs.replynodes.com/docs/mcp.md)
- [API Reference](https://docs.replynodes.com/reference)
- [Canonical OpenAPI JSON](https://docs.replynodes.com/api/openapi.json)
- [ReplyNodes on GitHub](https://github.com/replynodes)

## Provider guides

- [Web extraction](https://docs.replynodes.com/docs/guides/web) · [Markdown](https://docs.replynodes.com/docs/guides/web.md)
- [Web search](https://docs.replynodes.com/docs/guides/search) · [Markdown](https://docs.replynodes.com/docs/guides/search.md)
- [Brand intelligence](https://docs.replynodes.com/docs/guides/brand-intelligence) · [Markdown](https://docs.replynodes.com/docs/guides/brand-intelligence.md)
- [Brand Kit](https://docs.replynodes.com/docs/guides/brand-kit) · [Markdown](https://docs.replynodes.com/docs/guides/brand-kit.md) · WHEN TO USE: generate a local, inspectable brand context from one bare domain · Canonical source: https://github.com/replynodes/brand-kit
- [YouTube](https://docs.replynodes.com/docs/guides/youtube) · [Markdown](https://docs.replynodes.com/docs/guides/youtube.md)
- [Apple App Store](https://docs.replynodes.com/docs/guides/app-store) · [Markdown](https://docs.replynodes.com/docs/guides/app-store.md)
- [Google Play](https://docs.replynodes.com/docs/guides/google-play) · [Markdown](https://docs.replynodes.com/docs/guides/google-play.md)
- [Reddit](https://docs.replynodes.com/docs/guides/reddit) · [Markdown](https://docs.replynodes.com/docs/guides/reddit.md)

The generated llms-full.txt contains the source-backed page text. Provider availability, route names, schemas, and billing can change; re-read the live capability document before making a call.