Docs
Updated
Call Reddit and X tools over REST or MCP with one key.
Start here
Base URL and auth
Base URL
https://api.chatterapi.com/v1Auth: send Authorization: Bearer ca_live_... on every request. See Authentication.
Live tools
| Tool | Method | Path | Credits |
|---|---|---|---|
| Search posts | GET | /v1/reddit/search | 2 credits |
| Search 18+ posts | GET | /v1/reddit/nsfw/search | 2 credits |
| Search comments | GET | /v1/reddit/comments/search | 2 credits |
| Search media | GET | /v1/reddit/media/search | 2 credits |
| Get a post | GET | /v1/reddit/posts/{id} | 2 credits |
| Get a thread with comments | GET | /v1/reddit/threads/{id} | 3 credits |
| Search subreddits | GET | /v1/reddit/subreddits/search | 2 credits |
| Search 18+ subreddits | GET | /v1/reddit/nsfw/subreddits/search | 2 credits |
| Get a subreddit | GET | /v1/reddit/subreddits/{name} | 2 credits |
| List subreddit posts | GET | /v1/reddit/subreddits/{name}/posts | 2 credits |
| Get a user | GET | /v1/reddit/users/{name} | up to 3 credits |
| Get user status | GET | /v1/reddit/users/{name}/status | 2 credits |
| List user comments | GET | /v1/reddit/users/{name}/comments | 2 credits |
| List user posts | GET | /v1/reddit/users/{name}/posts | 2 credits |
| Search users | GET | /v1/reddit/users/search | 2 credits |
| Analyse a user | GET | /v1/reddit/users/{name}/analysis | up to 7 credits |
| Find leads | GET | /v1/reddit/leads | 4 credits |
| Get a user | GET | /v1/x/users/{handle} | 3 credits |
| Check a follow | GET | /v1/x/users/{source}/follows/{target} | 3 credits |
| Check a username | GET | /v1/x/users/{handle}/availability | 3 credits |
| Audit followers | GET | /v1/x/users/{handle}/follower-audit | 3 credits per call (up to 40 followers sampled) |
| Search followers | GET | /v1/x/users/{handle}/followers/search | 3 credits per page (20 rows by default) |
| Search users | GET | /v1/x/users/search | 3 credits |
| List followers | GET | /v1/x/users/{handle}/followers | 3 credits per page (20 rows by default) |
| List following | GET | /v1/x/users/{handle}/following | 3 credits per page (20 rows by default) |
| List verified followers | GET | /v1/x/users/{handle}/verified-followers | 4 credits per 20 rows |
| List user tweets | GET | /v1/x/users/{handle}/tweets | 3 credits |
| List mentions | GET | /v1/x/users/{handle}/mentions | 3 credits |
| Search tweets | GET | /v1/x/tweets/search | 3 credits |
| Get a tweet | GET | /v1/x/tweets/{id} | 3 credits |
| List replies | GET | /v1/x/tweets/{id}/replies | 3 credits |
| List retweeters | GET | /v1/x/tweets/{id}/retweeters | 3 credits |
| List members of a list | GET | /v1/x/lists/{id}/members | 3 credits |
| Find leads | GET | /v1/x/leads | 3 credits |
| Send a DM | POST | /v1/x/dm/send | 10 credits |
| Follow or unfollow | POST | /v1/x/actions/follow | 5 credits |
| Like or retweet | POST | /v1/x/actions/like | 5 credits |
| Post a tweet | POST | /v1/x/tweets | 5 credits |
| Search Reddit and X | GET | /v1/search | up to 5 credits |
| Find leads on Reddit and X | GET | /v1/leads | up to 6 credits |
| Find brand mentions | GET | /v1/mentions | up to 7 credits |
For agents and crawlers
- /llms.txt: a short index for language models.
- /llms-full.txt: all of these docs as one text file.
- /openapi.json: OpenAPI 3.1 for every live tool.
Paste this into your agent to set it up:
Set up ChatterAPI from https://chatterapi.com/llms.txt with my API key.chatterapi.com serves all three without a key.