Look Up 100 Subreddits in One Reddit API Call

Up to 100 subreddits in one call, by name.

Each subreddit comes back in the same shape as /api/reddit/sub/{name}/about: subscribers, active users, created date, type, NSFW flag, description and images. One call replaces up to 100 single lookups, at the price of one.

Query Parameters

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/api/reddit/subreddits/batch?names=python,LocalLLaMA,SaaS"

const response = await fetch(
  "https://api.redditapis.com/api/reddit/subreddits/batch?names=python,LocalLLaMA,SaaS",
  { headers: { Authorization: "Bearer TOKEN" } }
);
const { subreddits, missing } = await response.json();

import requests

response = requests.get(
    "https://api.redditapis.com/api/reddit/subreddits/batch",
    params={"names": "python,LocalLLaMA,SaaS"},
    headers={"Authorization": "Bearer TOKEN"},
)
data = response.json()

Response Shape

{
  "subreddits": [
    { "name": "Python", "fullname": "t5_2qh0y", "subscribers": 1400000, "subreddit_type": "public", "...": "same fields as /sub/{name}/about" }
  ],
  "requested": 3,
  "returned": 2,
  "missing": ["SaaS"]
}

Reddit leaves out a subreddit it will not serve, without saying why, so every name you sent is accounted for: it is in subreddits or in missing. A name is missing when the subreddit does not exist, is banned, or is private. To tell those apart for one name, read it with /api/reddit/sub/{name}/about, which answers 404 for one that does not exist.

Errors

Billed at the standard read price, $0.0015 per call, at any batch size.