Subreddits

Two small, related endpoints: search subreddits by name, and fetch a subreddit's posting rules. 1 credit per call, either endpoint. Want to see this data live first? Browse real subreddit pages built from these same endpoints.

GET/v1/subreddits/search

Search subreddits by name.

Returns up to 10 matches. No customer-facing limit and no pagination — cursor/has_more are always null/false.

Param	Type	Default	Notes
q *	string	—	Subreddit name or name prefix.

curl "https://api.threadsnoop.com/v1/subreddits/search?q=saas" \
  -H "x-api-key: ts_live_YOUR_KEY"

response (truncated)

{
  "data": [
    { "name": "SaaS", "subscribers": 180000, "description": "A place for SaaS founders..." }
  ],
  "_threadsnoop": {
    "cursor": null,
    "has_more": false,
    "credits_used": 1,
    "credits_remaining": 329
  }
}

GET/v1/subreddits/{name}/rules

A subreddit's posting rules.

Param	Type	Default	Notes
name *	string (path)	—	3–21 chars, letters/digits/underscore only.

curl "https://api.threadsnoop.com/v1/subreddits/SaaS/rules" \
  -H "x-api-key: ts_live_YOUR_KEY"

response (truncated)

{
  "data": {
    "subreddit": "SaaS",
    "rules": [
      { "short_name": "No self-promotion", "description": "Do not post ads or referral links.", "priority": 0 }
    ]
  },
  "_threadsnoop": { "credits_used": 1, "credits_remaining": 328 }
}