reddit/
trending-searches

Use the Reddit Trending Searches API to get the searches trending on Reddit today with no input at all, returning each search term, its rank in Reddit's list and a link to Reddit's results for it.

Reddit Trending Searches API

No input required
Ranked list
Search result links
0.5 credits / request
Ready
README

By SocQ · Updated

Reddit Trending Searches

Reddit trending searches are the short list of terms Reddit marks as trending today, usually around six, each with its position in the list and a link to the matching search results, and they often name news events, product launches and cultural moments as they unfold. Captured through the day, the list shows what people on Reddit are actively looking up, which feeds trend dashboards, timely content planning and alerts when a topic you follow starts trending.

Reddit Trending Searches API Features

  • No input to prepareThe request body is empty, so the call can run from a scheduler with nothing to configure.
  • Ranked in Reddit's orderrank starts at 1 and follows the order in which Reddit lists its trending searches.
  • Search link for every termkeyword holds the search term and url opens Reddit's search results for it, so each trend leads straight to the conversations behind it.

Reddit Trending Searches API Parameters

Ready to send

This endpoint does not require request parameters. Send the empty JSON object as-is.

{}

How to Use the Reddit Trending Searches API

Send an empty request to the Reddit Trending Searches API and read the current trending list.

  1. POST an empty JSON body {} to /v1/reddit/trending-searches.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read keyword and rank from results.items; if has_more is true, fetch the rest with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Reddit Trending Searches API Use Cases

  • Keeping a trend history: Store keyword, rank and collected_at from each run to chart how long topics stay on the list and how they move up or down.
  • Planning timely posts and articles: Check the current keywords each morning to decide which unfolding topics deserve a post, newsletter item or explainer that day.
  • Alerting on watched topics: Compare each keyword with a list of brand, product or industry terms and notify the team when one of them starts trending.

Reddit Trending Searches API Pro Tips

  • Key stored rows on keyword plus collected_at, because id equals the search term and the same term shows up again in later snapshots.
  • Pass a keyword to the Reddit Search API as query when you need the posts behind a trend, with their text, authors and engagement.

Beyond the Reddit Trending Searches API, use these APIs when you need a different type of public Reddit data.

  • Reddit Posts API — Collect public post text, authors, community context, media, timestamps, and visible engagement from supported Reddit URLs.
  • Reddit Search API — Search public Reddit posts by text query and publication window, returning normalized content, authors, community context, timestamps, media, and visible engagement.
  • Reddit Subreddit Details API
  • Reddit Subreddit Search API
  • Reddit Popular Feed API — Collect r/popular posts in hot, best, new, rising or top order, with title and body, author, score, comments and media.
  • Reddit Answers API — Ask a question and get Reddit's AI answer with the quoted comments, source posts and recommended subreddits.

Explore other platforms

Combine Reddit data with public data from other supported social platforms.

Reddit Trending Searches API — FAQ

Reddit Trending Searches API is a programmatic interface for retrieving the searches Reddit lists as trending today, with no input required. It returns each search term with its rank and a link to Reddit's results for it.

Usually six, ranked from 1 in the order Reddit lists them, which is the current list as Reddit shows it.

The Reddit Trending Searches API costs a flat 0.5 credits per call, whatever the number of searches on the list.