100 free credits. No credit card required
Reddit Omni Search API
Returns threads from across Reddit for one keyword with their top comments inline at top_comments, plus a roll-up of which subreddits are talking, their weekly active users and tone.
GET /v1/reddit/omni-searchLast updated October 2026Maintained by the SocialCrawl team
When to use the Reddit Omni Search API
Use it for a customer-listening sweep in one call rather than running search then post/comments per thread; it is slow and relevance is loose.
Not for a quick keyword search (reddit/search), one thread's full comments (reddit/post/comments) or other platforms (search/everywhere).
From the API reference
Runs reddit/search, expands the top N threads' comments in parallel (capped 15/thread), and rolls up which subreddits are talking. Each thread carries its comments at threads[].top_comments (the include parameter names this block comments; the field on the response is top_comments). Each rollup row is { name, subscribers, weekly_active_users, thread_count, tone }. subscribers is how many accounts have joined the community and weekly_active_users is how many took part in the last week. The second is NOT a subset of the first, because Reddit does not require joining to post or comment: measured on r/keyboards the weekly figure (188,869) is HIGHER than the subscriber count (147,416), while on r/technology it is far lower. Read them as two independent signals, size against liveliness, and never as a ratio. Both are filled from the same source as /v1/reddit/subreddit/details and inherit its behaviour, so on a small share of rows one or both can be null while the rest of the row is unchanged. tone is one LLM label per community and degrades to null with a _warnings line rather than a silent blank. 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 (a 10 to 12s median, with a tail past 30s, so allow a 60s client timeout) and relevance is loose: a VoC sweep, not precision ranking.
Searching 69 platforms in parallel
·
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search·TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal Search
TikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchReddit 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
# GET /v1/reddit/omni-search: Metered: holds 6 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
# --max-time 60: the API's own time limit for this endpoint.
# --retry 3: retries timeouts, 429 and 5xx, honoring Retry-After.
# -o response.json keeps only the final attempt's body.
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
IDEMPOTENCY_KEY=$(od -An -N16 -tx1 /dev/urandom | tr -d ' \n')
curl -sS --max-time 60 --retry 3 -o response.json \
-H "x-api-key: YOUR_API_KEY" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
"https://www.socialcrawl.dev/v1/reddit/omni-search?query=best+mechanical+keyboard&threads=5" && cat response.json# GET /v1/reddit/omni-search: Metered: holds 6 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
# Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
import os
import random
import time
import uuid
import requests
API_KEY = os.environ.get("SOCIALCRAWL_API_KEY", "YOUR_API_KEY")
TIMEOUT_S = 60 # the API's own time limit for this endpoint.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/reddit/omni-search"
def backoff(attempt):
# Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
return 2 ** attempt * (0.5 + random.random() / 2)
def socialcrawl(params):
# One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
idempotency_key = str(uuid.uuid4())
for attempt in range(MAX_RETRIES + 1):
try:
res = requests.get(
URL,
params=params,
headers={"x-api-key": API_KEY, "Idempotency-Key": idempotency_key},
timeout=TIMEOUT_S,
)
body = res.json()
except (requests.RequestException, ValueError):
# A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if attempt == MAX_RETRIES:
raise
time.sleep(backoff(attempt))
continue
if body["success"]:
return body
error = body["error"]
# Branch on error["type"], never on the message text.
if error["type"] == "RESOURCE_NOT_FOUND":
return None # refunded: nothing to read
retry_after = res.headers.get("Retry-After")
# SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
permanent = error["type"] == "SERVICE_UNAVAILABLE" and retry_after is None
if not error.get("retryable") or permanent or attempt == MAX_RETRIES:
raise RuntimeError(f"{error['type']}: {error['message']} (request_id {body['request_id']})")
# Retry-After (seconds) wins; otherwise back off.
time.sleep(float(retry_after) if retry_after else backoff(attempt))
params = {
"query": "best mechanical keyboard",
"threads": "5",
}
body = socialcrawl(params)
if body is not None:
print(body["data"])// GET /v1/reddit/omni-search: Metered: holds 6 credits per call up front and refunds what the call does not use. Cache hits are free and failed calls are refunded.
// Check the price first for 0 credits: add dry_run=1 to the query. Nothing is fetched or charged.
const API_KEY = process.env.SOCIALCRAWL_API_KEY ?? "YOUR_API_KEY";
const TIMEOUT_MS = 60_000; // the API's own time limit for this endpoint.
const MAX_RETRIES = 3;
type Page = { next_cursor: string | null; has_more: boolean };
type SocialCrawlResponse =
| { success: true; data: any; pagination?: Page; credits_used: number; request_id: string }
| { success: false; error: { type: string; message: string; retryable: boolean }; request_id: string };
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
// Exponential backoff with jitter: about 1 s, 2 s, then 4 s.
const backoffMs = (attempt: number) => 2 ** attempt * 1000 * (0.5 + Math.random() / 2);
async function socialcrawl(url: URL) {
// One Idempotency-Key per request, reused on every retry, so a retried call is never charged twice.
const idempotencyKey = crypto.randomUUID();
for (let attempt = 0; ; attempt++) {
let res: Response;
let body: SocialCrawlResponse;
try {
res = await fetch(url, {
headers: {
"x-api-key": API_KEY,
"Idempotency-Key": idempotencyKey,
},
signal: AbortSignal.timeout(TIMEOUT_MS),
});
body = (await res.json()) as SocialCrawlResponse;
} catch (error) {
// A timeout, a dropped connection or a non-JSON gateway page: retry with the same key.
if (attempt >= MAX_RETRIES) throw error;
await sleep(backoffMs(attempt));
continue;
}
if (body.success) return body;
// Branch on error.type, never on the message text.
if (body.error.type === "RESOURCE_NOT_FOUND") return null; // refunded: nothing to read
const retryAfter = res.headers.get("Retry-After");
// SERVICE_UNAVAILABLE without Retry-After is a withdrawn endpoint: permanent.
const permanent = body.error.type === "SERVICE_UNAVAILABLE" && retryAfter === null;
if (!body.error.retryable || permanent || attempt >= MAX_RETRIES) {
throw new Error(`${body.error.type}: ${body.error.message} (request_id ${body.request_id})`);
}
// Retry-After (seconds) wins; otherwise back off.
await sleep(retryAfter ? Number(retryAfter) * 1000 : backoffMs(attempt));
}
}
const url = new URL("https://www.socialcrawl.dev/v1/reddit/omni-search");
url.searchParams.set("query", "best mechanical keyboard");
url.searchParams.set("threads", "5");
const body = await socialcrawl(url);
if (body) console.log(body.data);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). The comments block is returned as `threads[].top_comments`. |
Example Response
What does the Reddit Omni Search API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "reddit",
"endpoint": "/v1/reddit/omni-search",
"data": {
"threads": [
{
"post": {
"id": "1w4c63y",
"url": "https://www.reddit.com/r/keyboards/comments/1w4c63y/whats_the_best_mechanical_keyboard_in_2026_price/",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": "user_2094f9",
"display_name": "user_8f6b77",
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": 14,
"comments": 48,
"shares": null,
"saves": null
},
"flags": {
"nsfw": false,
"spoiler": false,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-01T13:34:26.000Z",
"ext": {
"subreddit": "keyboards",
"title": "Sample comment text (redacted).",
"selftext": "I tried my buddy's board recently with brown tactile switches he told me last week and I actually loved that little bump not too loud but you still feel it. I dont want super clicky blue loud stuff because I'm on calls a lot so I don't want to disturb em. Really want something thocky and satisfying, hot-swappable would be amazing so I can try different switches later, maybe 75% or TKL? No idea! So far what interests me are Gateron Milky Yellow, Akko, Cherry MX Browns etc. Budget is around $180, trying to keep it under if possible",
"upvote_ratio": null,
"flair": null,
"content_language": null,
"published_at_epoch": 1788269666
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
},
"top_comments": {
"items": [
{
"comment": {
"id": "user_410bc5",
"url": "https://example.com/redacted",
"parent_id": "user_a4a2bd",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_cab8fd",
"display_name": "user_eaba57",
"avatar_url": "https://example.com/avatars/user_5a5f3a.png",
"verified": null
},
"engagement": {
"likes": 7,
"replies": 3
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-01T13:47:18.486Z",
"ext": {
"depth": 0,
"published_at_epoch": 1788270438
},
"replies": [
{
"id": "user_c68560",
"url": "https://example.com/redacted",
"parent_id": "user_410bc5",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_2094f9",
"display_name": "user_8f6b77",
"avatar_url": "https://example.com/avatars/user_fc4f3a.png",
"verified": null
},
"engagement": {
"likes": 1,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-01T14:48:18.953Z",
"ext": {
"depth": 1,
"published_at_epoch": 1788274098
},
"replies": [
{
"id": "user_53b940",
"url": "https://example.com/redacted",
"parent_id": "user_c68560",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_b33bb4",
"display_name": "user_332711",
"avatar_url": "https://example.com/avatars/user_aa4622.png",
"verified": null
},
"engagement": {
"likes": 2,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-01T15:04:29.492Z",
"ext": {
"depth": 2,
"published_at_epoch": 1788275069
}
}
]
},
{
"id": "user_089350",
"url": "https://example.com/redacted",
"parent_id": "user_410bc5",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_1410cb",
"display_name": "user_7cedb8",
"avatar_url": "https://example.com/avatars/user_d4093f.png",
"verified": null
},
"engagement": {
"likes": 1,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-11T08:21:00.428Z",
"ext": {
"depth": 1,
"published_at_epoch": 1789114860
}
}
]
},
"computed": {
"language": "en"
}
},
{
"comment": {
"id": "user_f68d6c",
"url": "https://example.com/redacted",
"parent_id": "user_a4a2bd",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_eaf02c",
"display_name": "user_85b9be",
"avatar_url": "https://example.com/avatars/user_497e68.png",
"verified": null
},
"engagement": {
"likes": 5,
"replies": 2
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-01T17:42:39.828Z",
"ext": {
"depth": 0,
"published_at_epoch": 1788284559
},
"replies": [
{
"id": "user_f16cdf",
"url": "https://example.com/redacted",
"parent_id": "user_f68d6c",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_2094f9",
"display_name": "user_8f6b77",
"avatar_url": "https://example.com/avatars/user_fc4f3a.png",
"verified": null
},
"engagement": {
"likes": 2,
"replies": 2
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-02T06:10:10.523Z",
"ext": {
"depth": 1,
"published_at_epoch": 1788329410
},
"replies": [
{
"id": "user_10a7e9",
"url": "https://example.com/redacted",
"parent_id": "user_f16cdf",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_eaf02c",
"display_name": "user_85b9be",
"avatar_url": "https://example.com/avatars/user_497e68.png",
"verified": null
},
"engagement": {
"likes": 2,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-02T06:54:40.035Z",
"ext": {
"depth": 2,
"published_at_epoch": 1788332080
}
},
{
"id": "user_cf593e",
"url": "https://example.com/redacted",
"parent_id": "user_f16cdf",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_6b01c0",
"display_name": "user_5a9470",
"avatar_url": "https://example.com/avatars/user_b6536c.png",
"verified": null
},
"engagement": {
"likes": 2,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-03T16:26:04.687Z",
"ext": {
"depth": 2,
"published_at_epoch": 1788452764
}
}
]
},
{
"id": "user_1b48b5",
"url": "https://example.com/redacted",
"parent_id": "user_f68d6c",
"post_id": "user_a4a2bd",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_30dde2",
"display_name": "user_2c2076",
"avatar_url": "https://example.com/avatars/user_7e54f5.png",
"verified": null
},
"engagement": {
"likes": 1,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-05T17:15:52.436Z",
"ext": {
"depth": 1,
"published_at_epoch": 1788628552
}
}
]
},
"computed": {
"language": "en"
}
}
],
"total": 23,
"next_cursor": null
}
},
{
"post": {
"id": "1wt7c82",
"url": "https://www.reddit.com/r/keyboards/comments/1wt7c82/reputable_brands/",
"content": {
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"media_urls": null,
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"username": null,
"display_name": null,
"avatar_url": null,
"verified": null
},
"engagement": {
"views": null,
"likes": 6,
"comments": 26,
"shares": null,
"saves": null
},
"flags": {
"nsfw": false,
"spoiler": false,
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T11:15:12.000Z",
"ext": {
"subreddit": "keyboards",
"title": "Sample comment text (redacted).",
"selftext": "I've just gotten a pc (hooray) and I'm in the market for a daily driver/gaming keyboard and my initial research swayed me to Epomaker/Aula. However I found some quite troubling info about them such as not accepting warranties, viruses in their software, keyboards suddenly not working etc etc. I'm now pretty unsure on what brands are actually good and worth the money, I want to buy something I can just have for years to come and is preferably mechanical or analog. I looked up Wooting keyboards which seem great but they're a lot of money. Do any of you have a list of recommendations? Thank you in advance for your help :)",
"upvote_ratio": null,
"flair": null,
"content_language": null,
"published_at_epoch": 1790680512
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": null
},
"top_comments": {
"items": [
{
"comment": {
"id": "user_38cf00",
"url": "https://example.com/redacted",
"parent_id": "user_8ef799",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_d4a43a",
"display_name": "user_bfe7ee",
"avatar_url": "https://example.com/avatars/user_28767c.png",
"verified": null
},
"engagement": {
"likes": 6,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T11:22:34.671Z",
"ext": {
"depth": 0,
"published_at_epoch": 1790680954
},
"replies": [
{
"id": "user_37e7e0",
"url": "https://example.com/redacted",
"parent_id": "user_38cf00",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_7d5ded",
"display_name": "user_e6d494",
"avatar_url": null,
"verified": null
},
"engagement": {
"likes": 2,
"replies": 2
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T11:27:24.721Z",
"ext": {
"depth": 1,
"published_at_epoch": 1790681244
},
"replies": [
{
"id": "user_df37fc",
"url": "https://example.com/redacted",
"parent_id": "user_37e7e0",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_4a4293",
"display_name": "user_50c143",
"avatar_url": "https://example.com/avatars/user_33212e.png",
"verified": null
},
"engagement": {
"likes": 4,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T11:52:25.209Z",
"ext": {
"depth": 2,
"published_at_epoch": 1790682745
},
"replies": [
{
"id": "user_3ab271",
"url": "https://example.com/redacted",
"parent_id": "user_df37fc",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted).",
"author": {
"username": "user_7d5ded",
"display_name": "user_e6d494",
"avatar_url": null,
"verified": null
},
"engagement": {
"likes": -7,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T11:53:33.804Z",
"ext": {
"depth": 3,
"published_at_epoch": 1790682813
},
"replies": [
{
"id": "user_7108d6",
"url": "https://example.com/redacted",
"parent_id": "user_3ab271",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_4a4293",
"display_name": "user_50c143",
"avatar_url": "https://example.com/avatars/user_33212e.png",
"verified": null
},
"engagement": {
"likes": 8,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T12:17:36.100Z",
"ext": {
"depth": 4,
"published_at_epoch": 1790684256
},
"replies": [
{
"id": "user_863c91",
"url": "https://example.com/redacted",
"parent_id": "user_7108d6",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_7d5ded",
"display_name": "user_e6d494",
"avatar_url": null,
"verified": null
},
"engagement": {
"likes": -8,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T12:21:25.943Z",
"ext": {
"depth": 5,
"published_at_epoch": 1790684485
},
"replies": [
{
"id": "user_81a115",
"url": "https://example.com/redacted",
"parent_id": "user_863c91",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_4a4293",
"display_name": "user_50c143",
"avatar_url": "https://example.com/avatars/user_33212e.png",
"verified": null
},
"engagement": {
"likes": 6,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T12:31:15.546Z",
"ext": {
"depth": 6,
"published_at_epoch": 1790685075
}
}
]
}
]
}
]
}
]
},
{
"id": "user_934d36",
"url": "https://example.com/redacted",
"parent_id": "user_37e7e0",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_d4a43a",
"display_name": "user_bfe7ee",
"avatar_url": "https://example.com/avatars/user_28767c.png",
"verified": null
},
"engagement": {
"likes": 1,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T12:21:09.128Z",
"ext": {
"depth": 2,
"published_at_epoch": 1790684469
},
"replies": [
{
"id": "user_5b6b8f",
"url": "https://example.com/redacted",
"parent_id": "user_934d36",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_7d5ded",
"display_name": "user_e6d494",
"avatar_url": null,
"verified": null
},
"engagement": {
"likes": 1,
"replies": 1
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T12:24:32.356Z",
"ext": {
"depth": 3,
"published_at_epoch": 1790684672
},
"replies": [
{
"id": "user_8ae0fc",
"url": "https://example.com/redacted",
"parent_id": "user_5b6b8f",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_d4a43a",
"display_name": "user_bfe7ee",
"avatar_url": "https://example.com/avatars/user_28767c.png",
"verified": null
},
"engagement": {
"likes": 1,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T12:54:54.098Z",
"ext": {
"depth": 4,
"published_at_epoch": 1790686494
}
}
]
}
]
}
]
}
]
},
"computed": {
"language": "en"
}
},
{
"comment": {
"id": "user_4dd5f7",
"url": "https://example.com/redacted",
"parent_id": "user_8ef799",
"post_id": "user_8ef799",
"text": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
"author": {
"username": "user_b78bf5",
"display_name": "user_74e9f2",
"avatar_url": "https://example.com/avatars/user_b6536c.png",
"verified": null
},
"engagement": {
"likes": 2,
"replies": null
},
"flags": {
"pinned": null,
"deleted": false
},
"published_at": "2026-09-29T14:10:45.972Z",
"ext": {
"depth": 0,
"published_at_epoch": 1790691045
}
},
"computed": {
"language": "en"
}
}
],
"total": 6,
"next_cursor": null
}
}
],
"subreddits": [
{
"name": "keyboards",
"subscribers": 149465,
"weekly_active_users": 153313,
"thread_count": 4,
"tone": "positive",
"tone_distribution": {
"positive": 0.6666666666666666,
"negative": 0,
"mixed": 0.2222222222222222,
"neutral": 0.1111111111111111,
"items": 12,
"counted": 9
}
},
{
"name": "buildapc",
"subscribers": 8535797,
"weekly_active_users": 1564590,
"thread_count": 1,
"tone": "positive",
"tone_distribution": {
"positive": 0.6,
"negative": 0,
"mixed": 0,
"neutral": 0.4,
"items": 6,
"counted": 5
}
}
],
"legs": [
{
"endpoint": "/v1/reddit/search",
"status": 200,
"credits_used": 1,
"latency_ms": 6483,
"error": null
},
{
"endpoint": "/v1/reddit/post/comments",
"status": 200,
"credits_used": 1,
"latency_ms": 686,
"error": null
}
],
"coverage": 1,
"partial_failure": false,
"next_cursor": "eyJhZnRlciI6InNjMi5leUp6SWpvaVlpSXNJbU1pT2lKbGVVcHFXVmMxYTJGWFVtaGtSMVo2V0ROS2JHUklWbmxpYlZaclNXcHZhV1V4ZDJsak1sWnFaRWRzZG1Kc09IaFlNMEp3WTBkV2MyRlhOV3hZZWtKbVdqSjRkbGx0Um5OWU1qRjJXa2RzYldGWFZubGpNWGRwVDJ4M2FVMVdkMmxNUm5kcFl6SldhbVJIYkhaaWJEaDRXRE5DY0dOSFZuTmhWelZzV0hwR1ptSkhPV3BaVjNobVlsYzVhMkZYV25CYVdFcDZXRU5KTmxoRFNYbFlRMGx6V0VOS2VscFhUakJoVnpsMVdIcEtabU5IYkhkYVYzaHdZbTFXWmsxVVJtWmpXRlpzWTI1c1ptTXpWbTVhTWxaNlpFZHNkbUp1VG1OSmFuQmpTV3BhWTBscGVHTkpiazVzV1ROU2NHSXlOV1pOYkRsM1lWaENiR0pIYkhWYVZqZzBXREpTTldKdFJuUmhWMDVtVFZZNWFHSnVUak5hV0VwNldETkNlVnBZV25CYVdHUmpTV3B3WTBscVFtTkphWGhqU1c1T2JGa3pVbkJpTWpWbVRXdzVkMkZZUW14aVIyeDFXbFk0TkZneVVqVmliVVowWVZkT1prMXNPWGRpTTA0d1dETk9iRmxZU21waFJuZHBUMngzYVU0eGQybE1SbmRwWXpKV2FtUkhiSFppYkRoNldETkNjR05IVm5OaFZ6VnNXSHBDWmxwSWJIVlpWekZ3V1RFNGQxZ3pUakZaYmtwc1drZFNjR1JHT1hwYVYwWjVXVEpvWTBscWNHTkphbFpqU1dsNFkwbHVUbXhaTTFKd1lqSTFaazB4T1hkaFdFSnNZa2RzZFZwV09IZFlNbEkxWW0xR2RHRlhUbVpOVmpsb1pGaFNiMkl6U21aak1sWm9ZMjFPYjFoRFNUWllRMGw0V0VOS09VbHBkMmxhU0d4MVdWY3hjRmt4T1doaVIzaG1ZMjFHZFdFeVZubEphbTlwWWtkV2JsbFhUalZZTWtaMVl6TmtiR051VFdsTVEwcHNaVWhDYkdOdGJHeGliVTVzV0ROT2JHSkhWbXBrUjJ4MlltbEpOa2x0VWpWaWJVWjBZVmRPWmxsWGVITkphWGRwV2xob2QxcFlTbkJhVnpWcVdsWTVNbHBZU25waFZ6bDFTV3B2YVZwSFZucGhNMUoyWTBOSmMwbHVUbXhaTTFKd1lqSTFaazFzT1hkaFdFSnNZa2RzZFZwV09EUllNbEkxWW0xR2RHRlhUbVpOYkRsM1lqTk9NRmd6VG14WldFcHFZVU5KTmtscVkybG1VVDA5SW4wIn0"
},
"credits_used": 6,
"request_id": "req_example000000",
"cached": false,
"credits_remaining": 9999,
"source": "captured",
"captured_at": "2026-10-02T12:43:00.707Z",
"redacted": true
}Live sample illustrating the unified response shape. Field values reflect the record you query.
API Details
How does the Reddit Omni Search API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
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 69 platforms covering 10B+ monthly active users.
One schema, every platform
Query 69 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record 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"
}
}
}FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I search all of Reddit with one API call?
Send GET /v1/reddit/omni-search?query=<keyword> with your API key. SocialCrawl's Reddit search API runs the search, expands the top threads' comments in parallel, and rolls up which subreddits are talking, so you get threads, attribution, and top comments in one response.
Does the Reddit search API include comments?
Yes. Each thread comes back with its top comments nested inline (capped at 15 per thread). Set threads to control how many of the top results get their comments expanded (1–8, default 8), or pass include=subreddits to skip comment expansion.
Can I scope the sweep to one subreddit?
Yes. Pass subreddit=MechanicalKeyboards (bare name, no r/ prefix) and the search runs scoped to that community. The response's subreddits rollup then collapses to that one subreddit with its thread count and tone.
How much does a Reddit search sweep cost?
It is metered: 1 credit per search page plus 1 credit per thread whose comments are expanded, with a 5-credit minimum. A failed thread is not billed, and the unused thread budget is refunded, so you only pay for what actually lands.
Why is the Reddit sweep slower than other searches?
Reddit search is the slowest social search on the API (typically 10–12 seconds) and its relevance is loose, so treat it as a voice-of-customer sweep, not precision ranking. Send Accept: text/event-stream to stream each thread as its comments land.
Ask AI about SocialCrawl
Ready to scrape Reddit Omni Search data?
Get your API key and start pulling Reddit data in under 60 seconds.