POST/api/v1/popularDiscover

Popular Feed

Retrieve the global r/popular feed, showing what is currently trending across all of Reddit, filtering out niche or highly controversial subreddits.

Ready to try it?

Create a free account — 30 requests included, no credit card.

Get free API key →

Request Parameters

Send as a JSON body in your POST request.

Parameter	Type	Required	Description
geo_filter	string	No	Filter trending posts by region (e.g., 'GLOBAL', 'US', 'GB', 'CA', 'AU'). Default: 'GLOBAL'.
limit	number	No	Number of posts to return (max 100). Default: 25.
after	string	No	Pagination cursor.

Code Examples

curl

curl -X POST https://subscraper.dev/api/v1/popular \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "geo_filter": "US",
    "limit": 5
  }'

TypeScript SDK

const feed = await client.getPopularPosts({
  geo_filter: "US",
  limit: 5
});

Install the SDK →

Sample Response

{
  "posts": [
    {
      "id": "t3_abc123",
      "title": "Breaking News: Major event happens today",
      "subreddit": "news",
      "score": 125000,
      "numComments": 8500,
      "url": "https://reddit.com/r/news/...",
      "createdAt": "2023-11-01T14:30:00Z"
    }
  ],
  "after": "t3_abc123"
}

Common Use Cases

Building a generalized news aggregator
Tracking global viral trends
Finding high-engagement content for curation

Credits

Each call to /api/v1/popular uses 1 credit. Free tier includes 30 credits. View pricing →

Related Tools & Guides

All developer tools →

Sandbox→

API Playground

Inspect current viral and trending submissions.

Use Case→

Reddit API for Content Research

Source trending topics for newsletters and social media.

Related Endpoints

explore— Explore Topics leaderboard— Leaderboard

Start using /popular now

Free tier — 30 requests, no credit card required.

Get free API key All endpoints →