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
Searching 42 platforms in parallel
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
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Keyword or phrase to sweep across Reddit. |
| threads | No | How many top threads to expand comments for (1–8, default 8). |
| sort | No | Search sort order (relevance | new | top | comment_count). (relevance | new | top | comment_count) |
| timeframe | No | Time window for the search (all | day | week | month | year). (all | day | week | month | year) |
| subreddit | No | Scope the sweep to one subreddit (bare name, no r/ prefix). |
| cursor | No | Opaque cursor from a prior response's next_cursor to page deeper. |
| include | No | CSV subset of subreddits,comments (default both). |
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
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(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usAsk AI about SocialCrawl
Ready to scrape Reddit Omni Search data?
Get your API key and start pulling Reddit data in under 60 seconds.
