100 free credits — no credit card required.Start building
Logo
100 free credits — no credit card required

Reddit Omni Search API

Scrape Reddit Omni Search data with one API call. Runs reddit/search, expands the top N threads' comments in parallel (capped 15/thread), and rolls up which subreddits are talking — volume + a per-community tone label. Returns sync JSON or a typed SSE stream that emits each thread as its comments land. Metered at 1 credit per search page + 1 credit per successfully-expanded thread (minimum 5); a failed thread isn't billed and the unused thread ceiling is refunded. `subreddit=` scopes the sweep to one community. The `next_cursor` resumes the search. Honest note: Reddit search is the slowest social search on the API (10–12s) and relevance is loose — a VoC sweep, not precision ranking.

Last updated June 2026

Try the Reddit Omni Search API

See real data before writing a single line

GET/v1/reddit/omni-search

Keyword or phrase to sweep across Reddit.

6 optional parameters

How many top threads to expand comments for (1–8, default 8).

Search sort order (relevance | new | top | comment_count).

Time window for the search (all | day | week | month | year).

Scope the sweep to one subreddit (bare name, no r/ prefix).

Opaque cursor from a prior response's next_cursor to page deeper.

CSV subset of subreddits,comments (default both).

Searching 42 platforms in parallel

·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal Search
·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal Search
Reddit API

What can you do with the Omni Search API?

The Omni Search endpoint gives you structured Reddit data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl "https://www.socialcrawl.dev/v1/reddit/omni-search?query=best+mechanical+keyboard" \
  -H "x-api-key: YOUR_API_KEY"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/reddit/omni-search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"query": "best mechanical keyboard"},
)
data = response.json()
const params = new URLSearchParams({
  "query": "best mechanical keyboard",
});

const response = await fetch(`https://www.socialcrawl.dev/v1/reddit/omni-search?${params}`, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

Parameters

ParameterRequiredDescription
queryYesKeyword or phrase to sweep across Reddit.
threadsNoHow many top threads to expand comments for (1–8, default 8).
sortNoSearch sort order (relevance | new | top | comment_count). (relevance | new | top | comment_count)
timeframeNoTime window for the search (all | day | week | month | year). (all | day | week | month | year)
subredditNoScope the sweep to one subreddit (bare name, no r/ prefix).
cursorNoOpaque cursor from a prior response's next_cursor to page deeper.
includeNoCSV subset of subreddits,comments (default both).
API Details

How does the Reddit Omni Search API work?

Send a GET request with your API key and get back clean, structured JSON. Every response follows our unified schema with computed fields.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for Reddit Omni Search data?

We handle the complexity of Reddit data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 42 platforms covering 10B+ monthly active users.

One schema, every platform

Query 42 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.

See your data before you code

Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 42 platforms
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us

Ask AI about SocialCrawl

Ready to scrape Reddit Omni Search data?

Get your API key and start pulling Reddit data in under 60 seconds.

Start for free