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

Universal Search Forums API

Scrape Universal Search Forums data with one API call. Fans your topic across Reddit, Hacker News, and Korean forums, RRF-fuses + clusters the threads, and enriches hero threads with their top comments by default (East + West). Naver threads are labeled raw (no comment endpoint). Returns a fused `items[]`, raw per-source buckets, thread clusters, and a deterministic computed block (question_share, top_communities). Flat 10cr with coverage-based partial refund.

Last updated June 2026

Try the Universal Search Forums API

See real data before writing a single line

GET/v1/search/forums

Search query (2–256 chars), forwarded to every forum search.

5 optional parameters

Optional CSV allowlist of forum sources (reddit, hackernews, naver_kin, naver_cafe). Mutually exclusive with exclude.

Optional CSV blocklist of forum sources. Mutually exclusive with sources.

Comment enrichment toggle (on|off, default on). 'off' returns thread-only.

Recency window passed to Reddit; HN filtered client-side (all|day|week|month|year, default all).

Alt recency window in days (1–365); HN filtered client-side.

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
Universal Search API

What can you do with the Forums API?

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

Example Request

curl "https://www.socialcrawl.dev/v1/search/forums?query=airpods+pro+3+battery" \
  -H "x-api-key: YOUR_API_KEY"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/search/forums",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"query": "airpods pro 3 battery"},
)
data = response.json()
const params = new URLSearchParams({
  "query": "airpods pro 3 battery",
});

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

Parameters

ParameterRequiredDescription
queryYesSearch query (2–256 chars), forwarded to every forum search.
sourcesNoOptional CSV allowlist of forum sources (reddit, hackernews, naver_kin, naver_cafe). Mutually exclusive with exclude.
excludeNoOptional CSV blocklist of forum sources. Mutually exclusive with sources.
commentsNoComment enrichment toggle (on|off, default on). 'off' returns thread-only.
timeframeNoRecency window passed to Reddit; HN filtered client-side (all|day|week|month|year, default all).
lookback_daysNoAlt recency window in days (1–365); HN filtered client-side.
API Details

How does the Universal Search Forums 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 Universal Search Forums data?

We handle the complexity of Universal Search 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

Ready to scrape Universal Search Forums data?

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

Start for free