API Reference
The Reddit Intel API exposes Reddit's public data as a typed REST surface plus a native MCP server, with quantitative trend signals layered on top. Base URL: https://api.redditintel.dev. All endpoints are versioned under /v1/.
Responses are JSON, wrapped in a consistent envelope. The full OpenAPI 3.1 specification is published at /v1/openapi.json.
Three ways to integrate
Pick the surface that fits your stack — the underlying data is identical across all three.
REST API
Twenty HTTP endpoints. Standard JSON, cursor pagination, predictable errors.
MCP server
Streamable-HTTP transport. Eighteen tools, three prompts, four resource templates.
Webhooks
Signed push notifications when a subreddit surges, a keyword spikes, or a post starts rising.
Before you begin
- 01Get an API key — Subscribe on a marketplace (API.market, Zyla, ApyHub) and grab your bearer token.
- 02Send it in every request — Pass it in the Authorization header. See Authentication for details.
- 03Pick your tier — Free, Pro, Business, or Scale — each unlocks different features and rate limits.
- 04Start with a small endpoint — GET /v1/subreddits/python is a good first call. No setup, just data.
A first request
Once you have a key, this command returns the public profile of any subreddit:
curl https://api.redditintel.dev/v1/subreddits/python \
-H "Authorization: Bearer <YOUR_API_KEY>"Response shape: { "data": { ... }, "meta": { "request_id": "..." } }. Full payload in Subreddits → Get subreddit metadata.