Subreddits

Two small, related endpoints: search subreddits by name, and fetch a subreddit's posting rules. 1 credit per call, either endpoint.

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

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

JavaScript (fetch)

const res = await fetch(
  "https://api.threadsnoop.com/v1/subreddits/search?q=saas",
  { headers: { "x-api-key": "ts_live_YOUR_KEY" } },
);
const data = await res.json();
console.log(data.data);

TypeScript (fetch)

type SubredditMatch = { name: string; subscribers: number; description: string };
type SubredditSearchResponse = {
  data: SubredditMatch[];
  _threadsnoop: { cursor: null; has_more: false; credits_used: number; credits_remaining: number };
};

const res = await fetch(
  "https://api.threadsnoop.com/v1/subreddits/search?q=saas",
  { headers: { "x-api-key": "ts_live_YOUR_KEY" } },
);
const data: SubredditSearchResponse = await res.json();
console.log(data.data);

python (requests)

import requests

r = requests.get(
    "https://api.threadsnoop.com/v1/subreddits/search",
    headers={"x-api-key": "ts_live_YOUR_KEY"},
    params={"q": "saas"},
)
data = r.json()
print(data["data"])

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

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

JavaScript (fetch)

const res = await fetch(
  "https://api.threadsnoop.com/v1/subreddits/SaaS/rules",
  { headers: { "x-api-key": "ts_live_YOUR_KEY" } },
);
const data = await res.json();
console.log(data.data.rules);

TypeScript (fetch)

type SubredditRule = { short_name: string; description: string; priority: number };
type SubredditRulesResponse = {
  data: { subreddit: string; rules: SubredditRule[] };
  _threadsnoop: { credits_used: number; credits_remaining: number };
};

const res = await fetch(
  "https://api.threadsnoop.com/v1/subreddits/SaaS/rules",
  { headers: { "x-api-key": "ts_live_YOUR_KEY" } },
);
const data: SubredditRulesResponse = await res.json();
console.log(data.data.rules);

python (requests)

import requests

r = requests.get(
    "https://api.threadsnoop.com/v1/subreddits/SaaS/rules",
    headers={"x-api-key": "ts_live_YOUR_KEY"},
)
data = r.json()
print(data["data"]["rules"])

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 }
}