# ChatterAPI

> ChatterAPI is a Reddit and X data API for developers and AI agents. One API key and one credit balance. REST at https://api.chatterapi.com/v1 and a hosted MCP server at https://api.chatterapi.com/mcp. Every response includes the credits it cost. Failed calls cost 0.

Auth: send `Authorization: Bearer ca_live_...`. Get a key at https://chatterapi.com/signup (100 free credits, no card).
ChatterAPI is independent and not affiliated with Reddit, Inc. or X Corp.

## Docs
- [Quickstart](https://chatterapi.com/docs/quickstart): first call, response envelope, pagination
- [Authentication](https://chatterapi.com/docs/authentication): key formats, live and test keys
- [Credits and billing](https://chatterapi.com/docs/credits): cost per tool, how balance works
- [Errors](https://chatterapi.com/docs/errors): every error code, retry rules, what to tell the user
- [Rate limits](https://chatterapi.com/docs/rate-limits)
- [Pagination](https://chatterapi.com/docs/pagination)
- [MCP server](https://chatterapi.com/docs/mcp): install in Claude Code, Cursor, Codex, Windsurf, VS Code, Claude Desktop

## Tools: Reddit
- [Search posts](https://chatterapi.com/docs/reddit/v1/reddit/search): `reddit.search`, GET /v1/reddit/search, 2 credits. Posts by keyword
- [Search 18+ posts](https://chatterapi.com/docs/reddit/v1/reddit/nsfw/search): `reddit.nsfw_search`, GET /v1/reddit/nsfw/search, 2 credits. Mature posts by keyword (requires 18+ opt-in)
- [Search comments](https://chatterapi.com/docs/reddit/v1/reddit/comments/search): `reddit.search_comments`, GET /v1/reddit/comments/search, 2 credits. Comments by keyword or author
- [Search media](https://chatterapi.com/docs/reddit/v1/reddit/media/search): `reddit.search_media`, GET /v1/reddit/media/search, 2 credits. Images, videos and galleries
- [Get a post](https://chatterapi.com/docs/reddit/v1/reddit/posts/:id): `reddit.scrape`, GET /v1/reddit/posts/{id}, 2 credits. Posts, threads and users to CSV or JSON
- [Get a thread with comments](https://chatterapi.com/docs/reddit/v1/reddit/threads/:id): `reddit.thread`, GET /v1/reddit/threads/{id}, 3 credits. A full thread to CSV, JSON or PDF
- [Search subreddits](https://chatterapi.com/docs/reddit/v1/reddit/subreddits/search): `reddit.communities`, GET /v1/reddit/subreddits/search, 2 credits. Communities for any topic
- [Search 18+ subreddits](https://chatterapi.com/docs/reddit/v1/reddit/nsfw/subreddits/search): `reddit.nsfw_communities`, GET /v1/reddit/nsfw/subreddits/search, 2 credits. Mature communities (requires 18+ opt-in)
- [Get a subreddit](https://chatterapi.com/docs/reddit/v1/reddit/subreddits/:name): `reddit.subreddit`, GET /v1/reddit/subreddits/{name}, 2 credits. Size, rules, mods and posting settings
- [List subreddit posts](https://chatterapi.com/docs/reddit/v1/reddit/subreddits/:name/posts): `reddit.subreddit_posts`, GET /v1/reddit/subreddits/{name}/posts, 2 credits. Hot, new, top and rising feeds
- [Get a user](https://chatterapi.com/docs/reddit/v1/reddit/users/:name): `reddit.user`, GET /v1/reddit/users/{name}, up to 3 credits. Profile, karma, age and badges
- [Get user status](https://chatterapi.com/docs/reddit/v1/reddit/users/:name/status): `reddit.user_status`, GET /v1/reddit/users/{name}/status, 2 credits. Active, suspended or shadowbanned
- [List user comments](https://chatterapi.com/docs/reddit/v1/reddit/users/:name/comments): `reddit.user_comments`, GET /v1/reddit/users/{name}/comments, 2 credits. Every comment an account made
- [List user posts](https://chatterapi.com/docs/reddit/v1/reddit/users/:name/posts): `reddit.user_posts`, GET /v1/reddit/users/{name}/posts, 2 credits. Every post an account submitted
- [Search users](https://chatterapi.com/docs/reddit/v1/reddit/users/search): `reddit.user_search`, GET /v1/reddit/users/search, 2 credits. Accounts by keyword
- [Analyse a user](https://chatterapi.com/docs/reddit/v1/reddit/users/:name/analysis): `reddit.user_analysis`, GET /v1/reddit/users/{name}/analysis, up to 7 credits. Top subreddits, karma split and activity hours
- [Find leads](https://chatterapi.com/docs/reddit/v1/reddit/leads): `reddit.leads`, GET /v1/reddit/leads, 4 credits. People asking for what you sell

## Tools: X
- [Get a user](https://chatterapi.com/docs/x/v1/x/users/:handle): `x.user`, GET /v1/x/users/{handle}, 3 credits. Profile, followers and bio by handle
- [Check a follow](https://chatterapi.com/docs/x/v1/x/users/:source/follows/:target): `x.follow_check`, GET /v1/x/users/{source}/follows/{target}, 3 credits. Does one account follow another
- [Search users](https://chatterapi.com/docs/x/v1/x/users/search): `x.user_search`, GET /v1/x/users/search, 3 credits. Accounts by keyword
- [List followers](https://chatterapi.com/docs/x/v1/x/users/:handle/followers): `x.followers`, GET /v1/x/users/{handle}/followers, 3 credits per page (20 rows by default). Anyone's followers to CSV
- [List following](https://chatterapi.com/docs/x/v1/x/users/:handle/following): `x.following`, GET /v1/x/users/{handle}/following, 3 credits per page (20 rows by default). Who an account follows
- [List verified followers](https://chatterapi.com/docs/x/v1/x/users/:handle/verified-followers): `x.verified_followers`, GET /v1/x/users/{handle}/verified-followers, 4 credits per 20 rows. Only the blue-check followers
- [List user tweets](https://chatterapi.com/docs/x/v1/x/users/:handle/tweets): `x.tweets`, GET /v1/x/users/{handle}/tweets, 3 credits. Every tweet from an account
- [List mentions](https://chatterapi.com/docs/x/v1/x/users/:handle/mentions): `x.mentions`, GET /v1/x/users/{handle}/mentions, 3 credits. Who is talking about a handle
- [Search tweets](https://chatterapi.com/docs/x/v1/x/tweets/search): `x.search`, GET /v1/x/tweets/search, 3 credits. Tweets by keyword, with operators
- [Get a tweet](https://chatterapi.com/docs/x/v1/x/tweets/:id): `x.tweet_detail`, GET /v1/x/tweets/{id}, 3 credits. One tweet with its stats
- [List replies](https://chatterapi.com/docs/x/v1/x/tweets/:id/replies): `x.replies`, GET /v1/x/tweets/{id}/replies, 3 credits. Every reply to a tweet
- [List retweeters](https://chatterapi.com/docs/x/v1/x/tweets/:id/retweeters): `x.retweeters`, GET /v1/x/tweets/{id}/retweeters, 3 credits. Who amplified a tweet
- [List members of a list](https://chatterapi.com/docs/x/v1/x/lists/:id/members): `x.list_members`, GET /v1/x/lists/{id}/members, 3 credits. Everyone on a list
- [Find leads](https://chatterapi.com/docs/x/v1/x/leads): `x.leads`, GET /v1/x/leads, 3 credits. People asking for what you sell
- [Send a DM](https://chatterapi.com/docs/x/v1/x/dm/send): `x.dm_send`, POST /v1/x/dm/send, 10 credits. From an account you connected
- [Follow or unfollow](https://chatterapi.com/docs/x/v1/x/actions/follow): `x.follow`, POST /v1/x/actions/follow, 5 credits. From an account you connected
- [Like or retweet](https://chatterapi.com/docs/x/v1/x/actions/like): `x.like`, POST /v1/x/actions/like, 5 credits. From an account you connected
- [Post a tweet](https://chatterapi.com/docs/x/v1/x/tweets): `x.tweet`, POST /v1/x/tweets, 5 credits. From an account you connected

## Tools: cross-platform
- [Search Reddit and X](https://chatterapi.com/docs/cross-platform/v1/search): `everywhere.search`, GET /v1/search, up to 5 credits. One keyword across Reddit and X
- [Find leads on Reddit and X](https://chatterapi.com/docs/cross-platform/v1/leads): `everywhere.leads`, GET /v1/leads, up to 6 credits. Buyers asking for your category, ranked
- [Find brand mentions](https://chatterapi.com/docs/cross-platform/v1/mentions): `everywhere.mentions`, GET /v1/mentions, up to 7 credits. Every mention of your brand

## Machine-readable
- [OpenAPI 3.1](https://chatterapi.com/openapi.json)
- [Full docs as text](https://chatterapi.com/llms-full.txt)

## Optional
- [Pricing](https://chatterapi.com/pricing): plans and credit costs
- [Free tools](https://chatterapi.com/tools): run tools without signup
- [Integrations](https://chatterapi.com/integrations): set up in Claude Code, Cursor, n8n, Zapier, LangChain and more
- [Use cases](https://chatterapi.com/use-cases): brand monitoring, lead generation, market research, AI agents
- [Subreddit stats](https://chatterapi.com/r): members, activity and top posts for popular subreddits
- [Reddit API status](https://chatterapi.com/reddit-api-status): every announced Reddit API and RSS shutdown date, with sources
- [Comparisons](https://chatterapi.com/compare) and [alternatives](https://chatterapi.com/alternatives): sourced, dated
- [Changelog](https://chatterapi.com/changelog)