POST/v1/reddit/popular-subreddits

Popular Subreddits API

List Reddit's most popular or newest subreddits with subscriber counts. $0.01 per call.

Get Reddit's list of popular subreddits or newly created ones. Each community includes name, title, description, subscriber count, creation date, type, language, icon, and banner, with cursor pagination.

Full Docs Get API Key — Free $5 Credit $0.01 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/reddit/popular-subredditsreddit-popular-subreddits$0.01/call

Response

Example response — hit "Send Request" to see a live result

{
  "ok": true,
  "data": {
    "cursor": "t5_2cneq",
    "subreddits": [
      {
        "active_users": null,
        "banner": null,
        "created_at": "2009-01-25T02:25:57+00:00",
        "created_utc": 1232850357,
        "description": null,
        "icon": null,
        "id": "2qs0k",
        "lang": "en",
        "name": "Home",
        "over_18": false,
        "subscribers": 435022,
        "title": "Home",
        "type": "public",
        "url": "https://www.reddit.com/r/Home/"
      }
    ]
  }
}

Features

✓

Popular or new

type=popular (default) returns Reddit's popular communities; type=new returns recently created ones.

✓

Full Subreddit objects

subscribers, description, created_at, over_18, type, lang, url, icon, and banner for each community.

✓

Cursor pagination

Page through the full list with the returned cursor.

✓

Cached for 1 hour

Lists are cached for an hour.

Use cases

Community Directories

Seed a directory of the biggest Reddit communities.

New Community Alerts

Spot new subreddits in your niche as they appear.

Market Sizing

Benchmark communities by subscriber count.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/reddit/popular-subreddits', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "popular"
  }),
});
const data = await res.json();
console.log(data);

The Popular Subreddits API for Reddit's biggest and newest communities

The YepAPI Popular Subreddits API returns Reddit's list of popular communities, or its newest ones. Call /v1/reddit/popular-subreddits and get subreddits with subscriber counts, descriptions, icons, and banners, at $0.01 per call.

Use type=popular to see where Reddit's biggest audiences are, or type=new to catch communities as soon as they are created.

What does the Popular Subreddits API return?

A subreddits array of full Subreddit objects (id, name, title, description, subscribers, active_users, created_at, over_18, type, lang, url, icon, banner) and a cursor.

Build directories and new-community alerts

Page through type=popular once to seed a directory of major communities, then poll type=new and match names and descriptions against your keywords to get alerted when a relevant community appears. Use the Subreddit API to track each one's growth afterwards.

Popular Subreddits API pricing: $0.01 per call

Every call costs a flat $0.01 and failed calls are free. There is no monthly minimum, no seat fee, and no Reddit app to register: you only need a YepAPI key. Lists are cached for an hour.

Try the Popular Subreddits API free

Sign up and get $5 in free credit with no card required. That is 500 calls at $0.01 each to test the Popular Subreddits API against live Reddit data before you spend anything. Every Reddit endpoint is on the same key.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

Get API Key — Free $5 Credit

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

Frequently asked questions

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/reddit/popular-subreddits. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.