# ThreadSnoop

> ThreadSnoop is a pay-per-read Reddit API built for AI agents and developers: posts, comments, comment trees, subreddit search, subreddit rules, and user profiles, read-only. 1 credit = 1 request, from $0.0015/read with bulk discounts to $0.001/read at $100+ top-ups, 100 free reads on signup with no card required. Connect directly over REST, or via a remote MCP server at api.threadsnoop.com/mcp (Claude Code, Claude Desktop, claude.ai web, Cursor). No writes, votes, DMs, or authenticated Reddit actions — ever.

Key facts:
- Category: Reddit read API / data API for AI agents, MCP clients, and developers
- Auth: `x-api-key` header (or `Authorization: Bearer`) on every request; get a key at https://threadsnoop.com/signup. Claude Code, Claude Desktop, and claude.ai web can also connect the MCP server via OAuth (Settings → Connectors → Add custom connector) with no key to create by hand.
- Endpoints (7, all `GET`, all read-only): `/v1/posts` (list or `ids=` batch fetch), `/v1/comments` (list or `ids=` batch fetch), `/v1/comments/tree`, `/v1/subreddits/search`, `/v1/subreddits/{name}/rules`, `/v1/users/{name}`, `/v1/account`
- MCP server: `https://api.threadsnoop.com/mcp`, seven tools mirroring the REST endpoints 1:1, same billing
- Machine-readable spec: https://threadsnoop.com/openapi.json
- Pricing: $0.0015/read base ($1.50/1,000), down to $0.0010/read ($1.00/1,000) at $100+ top-ups, credits never expire; 100 free reads on signup, no card
- Rate limit: 2 requests/second sustained, burst 10, per key
- A downloadable skill (`reddit-lead-finder`) packages the API into a finished "find Reddit leads for a product" workflow — a native Claude Skill plus a plain-markdown twin any other text-reading agent can use — at https://threadsnoop.com/skills/reddit-lead-finder

## Pages

- [Homepage](https://threadsnoop.com/): pricing, curl/Python/MCP setup, provider comparison, the reddit-lead-finder skill downloads
- [API docs](https://threadsnoop.com/docs): hub — quick start, MCP setup (Claude Code/Desktop/web), the skill, OpenAPI spec, links to every reference/endpoint page below
- [Authentication](https://threadsnoop.com/docs/authentication), [Credits & pricing](https://threadsnoop.com/docs/credits), [Rate limits](https://threadsnoop.com/docs/rate-limits), [Errors](https://threadsnoop.com/docs/errors), [Pagination](https://threadsnoop.com/docs/pagination)
- [GET /v1/posts](https://threadsnoop.com/docs/posts), [GET /v1/comments](https://threadsnoop.com/docs/comments), [GET /v1/comments/tree](https://threadsnoop.com/docs/comments-tree), [GET /v1/subreddits/search + rules](https://threadsnoop.com/docs/subreddits), [GET /v1/users/{name}](https://threadsnoop.com/docs/users), [GET /v1/account](https://threadsnoop.com/docs/account)
- [OpenAPI spec](https://threadsnoop.com/openapi.json): machine-readable, for custom GPT Actions, OpenAPI-driven client generators, or any agent framework that imports tool definitions from a spec
- [Playground](https://threadsnoop.com/playground): free, no-signup live demo — search any public subreddit and see real API results instantly, 5 free searches/day
- [Subreddits](https://threadsnoop.com/subreddits): live subscriber counts, posting rules, and top-scored recent posts for 100 of Reddit's biggest subreddits, each pulled through the API
- [Skills index](https://threadsnoop.com/skills): every packaged agent skill ThreadSnoop ships, with description, use cases, and downloads for each
- [reddit-lead-finder skill](https://threadsnoop.com/skills/reddit-lead-finder): `SKILL.md` (native Claude Skill) and `reddit-lead-finder.md` (plain-markdown, for any other agent)
- [Alternatives](https://threadsnoop.com/alternatives): ThreadSnoop vs. Reddit API alternatives, Reddit search/alert tools, and Reddit lead generation tools
- [Blog index](https://threadsnoop.com/blog)
- [How to Connect Reddit to Claude Code](https://threadsnoop.com/blog/give-claude-access-to-reddit)
- [How to Connect Reddit to Claude Desktop](https://threadsnoop.com/blog/claude-desktop-mcp-setup)
- [How to Connect Reddit to Claude.ai Web](https://threadsnoop.com/blog/claude-web-mcp-setup)
- [How to Connect Reddit to Cursor via MCP](https://threadsnoop.com/blog/cursor-mcp-setup)
- [How to Connect Reddit to Codex via MCP](https://threadsnoop.com/blog/codex-mcp-setup)
- [How to Give Claude Code Access to Reddit (Using an OpenAPI Spec)](https://threadsnoop.com/blog/give-claude-code-access-to-reddit)
- [How to Find Your First SaaS Customers on Reddit With Claude Code](https://threadsnoop.com/blog/find-saas-customers-claude-code)
- [How to Find Your First SaaS Customers on Reddit With Claude Desktop](https://threadsnoop.com/blog/find-saas-customers-claude-desktop)
- [How to Find Your First SaaS Customers on Reddit With Claude.ai Web](https://threadsnoop.com/blog/find-saas-customers-claude-web)
- [Using AI Agents to Search Reddit](https://threadsnoop.com/blog/ai-agents-search-reddit-claude-codex)
- [What Is the ThreadSnoop Reddit MCP Server?](https://threadsnoop.com/blog/what-is-the-reddit-mcp-server)
- [How to Actually Use the Reddit MCP Server (Beyond Setup)](https://threadsnoop.com/blog/reddit-mcp-usage-guide)
- [What Claude Desktop Actually Needs to Access the Reddit API](https://threadsnoop.com/blog/what-chatgpt-and-claude-desktop-need-to-access-reddit)
- [We Built a Reddit Lead-Finder Skill for Claude](https://threadsnoop.com/blog/reddit-lead-finder-skill)
- [Searching Reddit Programmatically: The API Guide](https://threadsnoop.com/blog/reddit-api-guide)
- [Reddit API Pricing in 2026](https://threadsnoop.com/blog/reddit-api-pricing-2026)
- [Reddit API Alternatives: Pricing Compared](https://threadsnoop.com/blog/reddit-api-alternatives)
- [How to Search Reddit With AI: The Complete Guide](https://threadsnoop.com/blog/search-reddit-with-ai-guide)
- [Build Your Own Semantic Reddit Search for Lead Discovery](https://threadsnoop.com/blog/build-semantic-reddit-search)
- [How to Find Reddit Users Who Need Your Product (Without Getting Banned)](https://threadsnoop.com/blog/find-reddit-users-for-your-product)
- [How to Leverage Claude to Find Your First SaaS Customers](https://threadsnoop.com/blog/claude-find-first-saas-customers)
- [How to Get Your First 10 Customers on Reddit](https://threadsnoop.com/blog/first-10-customers-on-reddit)
- [Why Can't Claude Access Reddit?](https://threadsnoop.com/blog/why-cant-claude-access-reddit)
- [Why Does Claude Get Rate Limited on Reddit With Playwright?](https://threadsnoop.com/blog/claude-playwright-reddit-rate-limited)
- [How to Connect Claude to Reddit: MCP, OpenAPI, or REST](https://threadsnoop.com/blog/give-my-ai-access-to-reddit)