Skip to main content

API docs

A fast, read-only Reddit API — posts, comments, comment trees, subreddits, and user profiles. Pay per request — 1 credit = 1 call, 1,000 free Reddit searches on signup, no card required. Full machine-readable spec at /openapi.json.

Quick start

  1. Sign up and verify your email.
  2. Finish account setup, then open /developer and create an API key — you get 1,000 free Reddit searches, no card required.
  3. Make your first call with the key — directly (below), or hand it to an AI agent over MCP instead.
curl "https://api.threadsnoop.com/v1/posts?subreddit=startups&limit=25" \
  -H "x-api-key: ts_live_YOUR_KEY"

Connecting Claude instead? One command:

Claude Code
claude mcp add --transport http threadsnoop https://api.threadsnoop.com/mcp \
  --header "x-api-key: ts_live_YOUR_KEY"

Claude Desktop and a downloadable lead-finding skill are both in Connect an AI agent below.

MCP server

A remote MCP server at https://api.threadsnoop.com/mcp, authenticated with the same x-api-key header. Seven tools, each billed exactly like the HTTP endpoint it wraps (1 credit/call; check_credits is free):

  • search_posts, search_comments — list/search posts and comments, or fetch by id.
  • get_comment_tree — full comment tree for a post.
  • search_subreddits, get_subreddit_rules — subreddit lookup.
  • get_user_profile — a Reddit user's karma/post/comment aggregate.
  • check_credits — balance + rate limit. Free.

Which do you use?

  1. One command, no OAuth traps:
    Terminal
    claude mcp add --transport http threadsnoop https://api.threadsnoop.com/mcp \
  --header "x-api-key: ts_live_YOUR_KEY"
  2. Paste the command in your terminal and press Enter.
  3. Start a session and ask Claude to search Reddit — the connection is live immediately.

Also listed on Smithery.

Skills

Free, packaged workflows on top of the API and MCP tools above — a finished playbook instead of raw endpoints. Read-only — none of them ever post, comment, or DM on Reddit itself.

Code guides

Prefer to write the code yourself? No SDK to install — each guide below is a real, runnable example against the live API.

OpenAPI spec

A machine-readable spec covering every endpoint, param, and response shape below — feed it into a client generator or any agent framework that imports tool definitions from a spec. /openapi.json.

Reference

Authentication

Pass your key as x-api-key or Authorization: Bearer. What a missing or revoked key returns.

Credits & pricing

1 credit = 1 read. The bulk-discount ladder from $0.0015 down to $0.0010/read.

Rate limits

2 requests/second sustained, burst 10, per key — plus the shared global upstream reserve.

Errors

401, 402, 429, and more — what triggers each, whether it's charged, and how to handle it.

Pagination

Cursor-based paging, and how the q= exact-phrase filter actually works.

Endpoints

7 endpoints. Every 200 response carries x-credits-used and x-credits-remaining headers alongside the JSON body's _threadsnoop block. Post and comment objects both include permalink (a relative path — prepend https://www.reddit.com for a clickable URL); posts also carry an absolute url field.

GET /v1/posts

List posts by subreddit/author, or batch-fetch specific posts by id.

GET /v1/comments

List comments by subreddit/author, or batch-fetch specific comments by id.

GET /v1/comments/tree

The full nested comment tree for a post, with a real comment count.

GET /v1/subreddits

Search subreddits by name, and fetch a subreddit's posting rules.

GET /v1/users/{name}

A Reddit user's karma/post/comment aggregate.

GET /v1/account

Check your credit balance and rate limit. Free — 0 credits.