# 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 (1,000 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
- [Reddit Post Search](https://chatterapi.com/docs/tools/reddit-search): `reddit.search`, GET /v1/reddit/search, 1 credit. Posts by keyword
- [Reddit NSFW Post Search](https://chatterapi.com/docs/tools/reddit-nsfw-search): `reddit.nsfw_search`, GET /v1/reddit/nsfw/search, 2 credits. Mature posts by keyword (requires 18+ opt-in)
- [Reddit Comment Search](https://chatterapi.com/docs/tools/reddit-search-comments): `reddit.search_comments`, GET /v1/reddit/comments/search, 2 credits. Comments by keyword or author
- [Reddit Media Search](https://chatterapi.com/docs/tools/reddit-search-media): `reddit.search_media`, GET /v1/reddit/media/search, 2 credits. Images, videos and galleries
- [Reddit Scraper](https://chatterapi.com/docs/tools/reddit-scrape): `reddit.scrape`, GET /v1/reddit/posts/{id}, 1 credit. Posts, threads and users to CSV or JSON
- [Reddit Comment Exporter](https://chatterapi.com/docs/tools/reddit-thread): `reddit.thread`, GET /v1/reddit/threads/{id}, 3 credits. A full thread to CSV, JSON or PDF
- [Subreddit Finder](https://chatterapi.com/docs/tools/reddit-communities): `reddit.communities`, GET /v1/reddit/subreddits/search, 2 credits. Communities for any topic
- [NSFW Subreddit Finder](https://chatterapi.com/docs/tools/reddit-nsfw-communities): `reddit.nsfw_communities`, GET /v1/reddit/nsfw/subreddits/search, 2 credits. Mature communities (requires 18+ opt-in)
- [Subreddit Stats](https://chatterapi.com/docs/tools/reddit-subreddit): `reddit.subreddit`, GET /v1/reddit/subreddits/{name}, 2 credits. Size, rules, mods and posting settings
- [Subreddit Posts](https://chatterapi.com/docs/tools/reddit-subreddit-posts): `reddit.subreddit_posts`, GET /v1/reddit/subreddits/{name}/posts, 1 credit. Hot, new, top and rising feeds
- [Reddit User Lookup](https://chatterapi.com/docs/tools/reddit-user): `reddit.user`, GET /v1/reddit/users/{name}, up to 2 credits. Profile, karma, age and badges
- [Reddit Account Checker](https://chatterapi.com/docs/tools/reddit-user-status): `reddit.user_status`, GET /v1/reddit/users/{name}/status, 2 credits. Active, suspended or shadowbanned
- [Reddit Comment History](https://chatterapi.com/docs/tools/reddit-user-comments): `reddit.user_comments`, GET /v1/reddit/users/{name}/comments, 2 credits. Every comment an account made
- [Reddit Post History](https://chatterapi.com/docs/tools/reddit-user-posts): `reddit.user_posts`, GET /v1/reddit/users/{name}/posts, 1 credit. Every post an account submitted
- [Reddit User Search](https://chatterapi.com/docs/tools/reddit-user-search): `reddit.user_search`, GET /v1/reddit/users/search, 2 credits. Accounts by keyword
- [Reddit Lead Finder](https://chatterapi.com/docs/tools/reddit-leads): `reddit.leads`, GET /v1/reddit/leads, 3 credits. People asking for what you sell

## Tools: X
- [X User Lookup](https://chatterapi.com/docs/tools/x-user): `x.user`, GET /v1/x/users/{handle}, 3 credits. Profile, followers and bio by handle
- [X User Search](https://chatterapi.com/docs/tools/x-user-search): `x.user_search`, GET /v1/x/users/search, 3 credits. Accounts by keyword
- [X Follower Exporter](https://chatterapi.com/docs/tools/x-followers): `x.followers`, GET /v1/x/users/{handle}/followers, 3 credits per page (20 rows by default). Anyone's followers to CSV
- [X Following Exporter](https://chatterapi.com/docs/tools/x-following): `x.following`, GET /v1/x/users/{handle}/following, 3 credits per page (20 rows by default). Who an account follows
- [Verified Follower Exporter](https://chatterapi.com/docs/tools/x-verified-followers): `x.verified_followers`, GET /v1/x/users/{handle}/verified-followers, 4 credits per 20 rows. Only the blue-check followers
- [X Timeline Scraper](https://chatterapi.com/docs/tools/x-tweets): `x.tweets`, GET /v1/x/users/{handle}/tweets, 3 credits. Every tweet from an account
- [X Mentions Monitor](https://chatterapi.com/docs/tools/x-mentions): `x.mentions`, GET /v1/x/users/{handle}/mentions, 3 credits. Who is talking about a handle
- [X Tweet Search](https://chatterapi.com/docs/tools/x-search): `x.search`, GET /v1/x/tweets/search, 3 credits. Tweets by keyword, with operators
- [X Tweet Lookup](https://chatterapi.com/docs/tools/x-tweet-detail): `x.tweet_detail`, GET /v1/x/tweets/{id}, 3 credits. One tweet with its stats
- [Tweet Replies Exporter](https://chatterapi.com/docs/tools/x-replies): `x.replies`, GET /v1/x/tweets/{id}/replies, 3 credits. Every reply to a tweet
- [Retweeter Exporter](https://chatterapi.com/docs/tools/x-retweeters): `x.retweeters`, GET /v1/x/tweets/{id}/retweeters, 3 credits. Who amplified a tweet
- [X List Members](https://chatterapi.com/docs/tools/x-list-members): `x.list_members`, GET /v1/x/lists/{id}/members, 3 credits. Everyone on a list
- [X Lead Finder](https://chatterapi.com/docs/tools/x-leads): `x.leads`, GET /v1/x/leads, 3 credits. People asking for what you sell

## Tools: cross-platform
- [Search Everywhere](https://chatterapi.com/docs/tools/everywhere-search): `everywhere.search`, GET /v1/search, up to 4 credits. One keyword across Reddit and X
- [Lead Finder](https://chatterapi.com/docs/tools/everywhere-leads): `everywhere.leads`, GET /v1/leads, up to 5 credits. Buyers asking for your category, ranked
- [Brand Mentions](https://chatterapi.com/docs/tools/everywhere-mentions): `everywhere.mentions`, GET /v1/mentions, up to 6 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
- [Changelog](https://chatterapi.com/changelog)