ReplyNodes documentation
ReplyNodes is a web context API for AI agents. Search, scrape and read public web, social and app data through one REST API or one remote MCP server, with normalized { data, meta } responses. Data endpoints only read public data. The monitor and watch endpoints manage your own scheduled monitors. Nothing here publishes content or posts to a social account.
Start here
- Quickstart: get a key and make your first request.
- Agent quickstart: start with no key and add one only when you need it.
- API reference: the interactive reference for every operation.
Choose an API
| You have | You want | Use | Guide |
|---|---|---|---|
| A public URL | The page as Markdown | GET /v1/webcontext/scrape | Web context |
| A site URL | Its list of URLs, or several pages | GET /v1/webcontext/map, GET /v1/webcontext/crawl | Web context |
| A question or keywords | Web search results | GET /v1/web/search | Search |
| A company domain | Logo, colors, fonts, social links | GET /v1/brand/* | Brand intelligence |
| A domain and 1 to 5 competitor domains | A combined dossier | GET /v1/competitor-research | Competitor research |
| A topic, subreddit or user | Reddit posts and activity | GET /v1/reddit/* | |
| A search term, video, channel or playlist | YouTube data and transcripts | GET /v1/youtube/* | YouTube |
| An app name or id | Apple App Store listings and reviews | GET /v1/appstore/* | App Store |
| An app name or package id | Google Play listings and reviews | GET /v1/googleplay/* | Google Play |
Make your first request
Set REPLYNODES_API_KEY from a secret store, then fetch a public page as Markdown. You can create a key on the API keys page, and the Quickstart walks through it.
curl -sS \
-H "Authorization: Bearer $REPLYNODES_API_KEY" \
"https://api.replynodes.com/v1/webcontext/scrape?url=https%3A%2F%2F2.zoppoz.workers.dev%3A443%2Fhttps%2Fexample.com"A successful response is a { data, meta } envelope. Keep meta.request_id to correlate a call with a support investigation. The Quickstart shows the response shape.
Connect an MCP client
Interactive clients only need the server URL and sign in with OAuth. Headless clients and CI send an API key as a Bearer header. The server URL is:
https://mcp.replynodes.com/mcpClient-by-client setup is in MCP.
Account and operations
- Authentication: key types, scopes, OAuth, rotation and revocation.
- Limits and pricing: keyless quotas, per-endpoint limits and packages.
- Errors: every error code, whether to retry, and what to do.
- Production: secure and reliable client rules.
For agents
Read llms.txt, llms-full.txt and the OpenAPI JSON. Add .md to any docs URL for a Markdown copy. If a guide and the API reference disagree, trust the reference.