100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
Universal Search logo
100 크레딧 무료, 카드 등록 없이

Universal Search Forums API

Reddit과 Hacker News, 한국 커뮤니티의 토론 스레드를 하나로 합쳐 군집을 매깁니다. 주요 스레드에는 상위 댓글을 300자까지 잘라 붙입니다.

GET /v1/search/forums
무료로 시작하기응답 예시 보기

2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요

Universal Search Forums API는 언제 쓰나요

영상이나 코드, 소셜 게시물까지 보려면 search/everywhere가 맞습니다. 사람들이 실제로 묻고 답한 내용만 볼 때 사용하세요.

API 레퍼런스 영문 원문

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). Each row of items[].top_comments[] is { score, excerpt, truncated, author, url, date }. The body is excerpt, not text: this is the search-lane enrichment shape, not the canonical Comment archetype, and it is clipped to 300 characters on a word boundary, with an ellipsis and truncated: true when it was cut. date is the comment ISO timestamp. Flat 10cr with coverage-based partial refund.

69개 플랫폼을 병렬로 검색합니다

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
Universal Search API

Forums API로 무엇을 할 수 있을까요

Forums 엔드포인트가 통합 스키마와 계산 필드를 담은 Universal Search 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

# GET /v1/search/forums: 10 credits per call. 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 22: this endpoint's measured p99 latency x 1.5.
# --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 22 --retry 3 -o response.json \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://www.socialcrawl.dev/v1/search/forums?query=airpods+pro+3+battery&sources=reddit%2Chackernews%2Cnaver_kin&comments=on" && cat response.json
# GET /v1/search/forums: 10 credits per call. 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 = 22  # this endpoint's measured p99 latency x 1.5.
MAX_RETRIES = 3
URL = "https://www.socialcrawl.dev/v1/search/forums"


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": "airpods pro 3 battery",
    "sources": "reddit,hackernews,naver_kin",
    "comments": "on",
}
body = socialcrawl(params)
if body is not None:
    print(body["data"])
// GET /v1/search/forums: 10 credits per call. 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 = 22_000; // this endpoint's measured p99 latency x 1.5.
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/search/forums");
url.searchParams.set("query", "airpods pro 3 battery");
url.searchParams.set("sources", "reddit,hackernews,naver_kin");
url.searchParams.set("comments", "on");

const body = await socialcrawl(url);
if (body) console.log(body.data);

파라미터

파라미터필수설명
query예Search query (2-256 chars), forwarded to every forum search.
sources아니오Optional CSV allowlist of forum sources (reddit, hackernews, naver_kin, naver_cafe). Mutually exclusive with exclude.
exclude아니오Optional CSV blocklist of forum sources. Mutually exclusive with sources.
comments아니오Comment enrichment toggle (on|off, default on). 'off' returns thread-only.
timeframe아니오Recency window passed to Reddit; HN filtered client-side (all|day|week|month|year, default all).
lookback_days아니오Alt recency window in days (1-365); HN filtered client-side.
relevance아니오Optional. Without it every thread already carries items[].computed.relevance ({ p, sense, on_topic }: is the thread about what your query means, or a different thing that shares its words?), free, in the fused order (see judgments). score also reorders threads by relevance blended with their fused rank. filter also drops the threads that are not on topic, lists them in data.relevance.dropped_ids, and counts stance_split, question_share and top_communities over the threads it kept. A thread that could not be judged, or is too short to judge, is never dropped and carries relevance: null. Omit it to keep every thread in the fused order. Included in the flat 10 credits. (score | filter)
relevance_threshold아니오Optional, only with relevance. The probability (0 to 1) a thread must reach to count as on topic. Default 0.5. Lower keeps more threads, higher keeps fewer.
judgments아니오Optional. on (default) or off. On, every thread also carries items[].computed.relevance ({ p, sense, on_topic }) from the same stance judgment, with data.relevance (mode default) counting it; the fused order is kept and nothing is dropped (relevance=score or filter reorders and drops). off returns the response without it. Included in the flat 10 credits. (on | off)
응답 예시

Universal Search Forums API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기
{
  "success": true,
  "platform": "search",
  "endpoint": "/v1/search/forums",
  "data": {
    "items": [
      {
        "title": "Do Airpods Pro 3 really have terrible battery life?",
        "url": "https://www.reddit.com/r/AirpodsPro/comments/1w63726/do_airpods_pro_3_really_have_terrible_battery_life/",
        "source": "reddit",
        "container": "r/AirpodsPro",
        "enrichable": true,
        "post": {
          "item_id": "1w63726",
          "source": "reddit",
          "title": "Do Airpods Pro 3 really have terrible battery life?",
          "body": "The charging case continues to lose battery even when the AirPods are not in use for several days. Charging the AirPods from 84% to 100% also consumes around 20% of the case’s battery. It's a brand new Airpods Pro 3.",
          "url": "https://www.reddit.com/r/AirpodsPro/comments/1w63726/do_airpods_pro_3_really_have_terrible_battery_life/",
          "author": "user_79c0e5",
          "published_at": "2026-09-03T10:09:52.000Z",
          "date_confidence": "low",
          "engagement": {
            "score": 25,
            "num_comments": 54
          },
          "relevance_hint": 0.5,
          "why_relevant": "",
          "snippet": "",
          "metadata": {
            "enrichable": true,
            "top_comments": [
              {
                "score": 42,
                "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                "truncated": false,
                "author": "user_5beea1",
                "url": "https://example.com/redacted",
                "date": "2026-09-03T10:27:53.966Z"
              },
              {
                "score": 16,
                "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                "truncated": false,
                "author": "user_51150e",
                "url": "https://example.com/redacted",
                "date": "2026-09-03T12:36:21.327Z"
              }
            ]
          },
          "media": {
            "thumbnail_url": null,
            "video_url": null,
            "duration_s": null,
            "image_urls": [],
            "aspect_ratio": null,
            "author_avatar_url": null,
            "favicon_url": null
          },
          "container": "r/AirpodsPro",
          "local_relevance": 0.7964285714285714,
          "freshness": 51,
          "engagement_score": 64,
          "source_quality": 0.6,
          "local_rank_score": 0.7091785714285714
        },
        "top_comments": [
          {
            "score": 42,
            "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
            "truncated": false,
            "author": "user_5beea1",
            "url": "https://example.com/redacted",
            "date": "2026-09-03T10:27:53.966Z"
          },
          {
            "score": 16,
            "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
            "truncated": false,
            "author": "user_51150e",
            "url": "https://example.com/redacted",
            "date": "2026-09-03T12:36:21.327Z"
          }
        ],
        "rrf_score": 0.01639344262295082,
        "cluster_id": "cluster-1",
        "computed": {
          "stance": {
            "label": "negative",
            "confidence": 1
          },
          "relevance": {
            "p": 0.96,
            "sense": "target",
            "on_topic": true
          }
        }
      },
      {
        "title": "Ask HN: How can I make wired Airpods Pro?",
        "url": null,
        "source": "hackernews",
        "container": "Hacker News",
        "enrichable": true,
        "post": {
          "item_id": "29185994",
          "source": "hackernews",
          "title": "Ask HN: How can I make wired Airpods Pro?",
          "body": "I mostly use my Airpods Pro for their Active Noise Cancelling whilst working at my desk for ~8 hours a day.<p>I&#x27;m finding their relatively short battery life and gradually deteriorating capacity highly frustrating (and ultimately wasteful).<p>Is there a way to power these in wired mode? Surely something like a USB-C cable can do this?<p>For comparison, I still have and use my original wired EarPods with their 3.5mm jack from back in the day - which work perfectly after many years of heavy use.<p>I wish Apple would release a USB-C wired version of these with Active Noise Cancelling like in their AirPods Pro.<p>It would be helluva practical for those long work sessions and also better for the environment.<p>My next best bet is the Bose QC20 - but even these have a quasi-battery solution which ultimately depletes.",
          "url": null,
          "author": "user_02ee93",
          "published_at": "2021-11-11T09:05:52.000Z",
          "date_confidence": "low",
          "engagement": {
            "points": 15,
            "comments": 20
          },
          "relevance_hint": 0.5,
          "why_relevant": "",
          "snippet": "",
          "metadata": {
            "enrichable": true,
            "top_comments": [
              {
                "score": null,
                "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                "truncated": true,
                "author": "user_68d2e3",
                "url": "https://example.com/redacted",
                "date": "2021-11-11T09:52:04.000Z"
              },
              {
                "score": null,
                "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                "truncated": false,
                "author": "user_765036",
                "url": "https://example.com/redacted",
                "date": "2021-11-11T11:12:28.000Z"
              }
            ]
          },
          "media": {
            "thumbnail_url": null,
            "video_url": null,
            "duration_s": null,
            "image_urls": [],
            "aspect_ratio": null,
            "author_avatar_url": null,
            "favicon_url": null
          },
          "container": "Hacker News",
          "local_relevance": 0.6393333333333333,
          "freshness": 0,
          "engagement_score": 100,
          "source_quality": 0.8,
          "local_rank_score": 0.5155666666666666
        },
        "top_comments": [
          {
            "score": null,
            "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
            "truncated": true,
            "author": "user_68d2e3",
            "url": "https://example.com/redacted",
            "date": "2021-11-11T09:52:04.000Z"
          },
          {
            "score": null,
            "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
            "truncated": false,
            "author": "user_765036",
            "url": "https://example.com/redacted",
            "date": "2021-11-11T11:12:28.000Z"
          }
        ],
        "rrf_score": 0.01639344262295082,
        "cluster_id": "cluster-1",
        "computed": {
          "stance": {
            "label": "negative",
            "confidence": 0.89
          },
          "relevance": {
            "p": 0.63,
            "sense": "target",
            "on_topic": true
          }
        }
      }
    ],
    "items_by_source": {
      "hackernews": {
        "items": [
          {
            "item_id": "29185994",
            "source": "hackernews",
            "title": "Sample comment text (redacted).",
            "body": "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).",
            "url": "",
            "author": "user_02ee93",
            "published_at": "2021-11-11T09:05:52.000Z",
            "date_confidence": "low",
            "engagement": {
              "points": 15,
              "comments": 20
            },
            "relevance_hint": 0.5,
            "why_relevant": "",
            "snippet": "Sample comment text (redacted).",
            "metadata": {
              "enrichable": true,
              "top_comments": [
                {
                  "score": null,
                  "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                  "truncated": true,
                  "author": "user_68d2e3",
                  "url": "https://example.com/redacted",
                  "date": "2021-11-11T09:52:04.000Z"
                },
                {
                  "score": null,
                  "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_765036",
                  "url": "https://example.com/redacted",
                  "date": "2021-11-11T11:12:28.000Z"
                }
              ]
            },
            "media": {
              "thumbnail_url": null,
              "video_url": null,
              "duration_s": null,
              "image_urls": [],
              "aspect_ratio": null,
              "author_avatar_url": null,
              "favicon_url": null
            },
            "container": "Hacker News",
            "local_relevance": 0.6393333333333333,
            "freshness": 0,
            "engagement_score": 100,
            "source_quality": 0.8,
            "local_rank_score": 0.5155666666666666
          },
          {
            "item_id": "42610644",
            "source": "hackernews",
            "title": "Sample comment text (redacted).",
            "body": "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).",
            "url": "https://github.com/user_837162/aln",
            "author": "user_aff807",
            "published_at": "2025-01-06T14:07:21.000Z",
            "date_confidence": "low",
            "engagement": {
              "points": 3,
              "comments": 2
            },
            "relevance_hint": 0.5,
            "why_relevant": "",
            "snippet": "Sample comment text (redacted).",
            "metadata": {
              "enrichable": true,
              "top_comments": [
                {
                  "score": null,
                  "excerpt": "Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_818c06",
                  "url": "https://example.com/redacted",
                  "date": "2025-01-06T19:20:01.000Z"
                },
                {
                  "score": null,
                  "excerpt": "Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_e5d0d6",
                  "url": "https://example.com/redacted",
                  "date": "2025-01-06T19:39:30.000Z"
                }
              ]
            },
            "media": {
              "thumbnail_url": null,
              "video_url": null,
              "duration_s": null,
              "image_urls": [],
              "aspect_ratio": null,
              "author_avatar_url": null,
              "favicon_url": null
            },
            "container": "Hacker News",
            "local_relevance": 0.4851478494623655,
            "freshness": 0,
            "engagement_score": 28,
            "source_quality": 0.8,
            "local_rank_score": 0.3433461021505376
          }
        ],
        "enrichable": true
      },
      "naver_kin": {
        "items": [],
        "enrichable": false,
        "raw": true
      },
      "reddit": {
        "items": [
          {
            "item_id": "1w63726",
            "source": "reddit",
            "title": "Sample comment text (redacted).",
            "body": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
            "url": "https://www.reddit.com/r/AirpodsPro/comments/1w63726/do_airpods_pro_3_really_have_terrible_battery_life/",
            "author": "user_79c0e5",
            "published_at": "2026-09-03T10:09:52.000Z",
            "date_confidence": "low",
            "engagement": {
              "score": 25,
              "num_comments": 54
            },
            "relevance_hint": 0.5,
            "why_relevant": "",
            "snippet": "Sample comment text (redacted).",
            "metadata": {
              "enrichable": true,
              "top_comments": [
                {
                  "score": 42,
                  "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_5beea1",
                  "url": "https://example.com/redacted",
                  "date": "2026-09-03T10:27:53.966Z"
                },
                {
                  "score": 16,
                  "excerpt": "Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted). Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_51150e",
                  "url": "https://example.com/redacted",
                  "date": "2026-09-03T12:36:21.327Z"
                }
              ]
            },
            "media": {
              "thumbnail_url": null,
              "video_url": null,
              "duration_s": null,
              "image_urls": [],
              "aspect_ratio": null,
              "author_avatar_url": null,
              "favicon_url": null
            },
            "container": "r/AirpodsPro",
            "local_relevance": 0.7964285714285714,
            "freshness": 51,
            "engagement_score": 64,
            "source_quality": 0.6,
            "local_rank_score": 0.7091785714285714
          },
          {
            "item_id": "1ws7b1y",
            "source": "reddit",
            "title": "Sample comment text (redacted).",
            "body": "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).",
            "url": "https://www.reddit.com/r/airpods/comments/1ws7b1y/worst_experience_in_my_life_with_airpods_pro_3/",
            "author": "user_517fb2",
            "published_at": "2026-09-28T06:43:40.000Z",
            "date_confidence": "low",
            "engagement": {
              "score": 0,
              "num_comments": 18
            },
            "relevance_hint": 0.5,
            "why_relevant": "",
            "snippet": "Sample comment text (redacted).",
            "metadata": {
              "enrichable": true,
              "top_comments": [
                {
                  "score": 11,
                  "excerpt": "Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_2f89ca",
                  "url": "https://example.com/redacted",
                  "date": "2026-09-28T07:00:02.855Z"
                },
                {
                  "score": 5,
                  "excerpt": "Sample comment text (redacted).",
                  "truncated": false,
                  "author": "user_000cfd",
                  "url": "https://example.com/redacted",
                  "date": "2026-09-28T07:48:17.877Z"
                }
              ]
            },
            "media": {
              "thumbnail_url": null,
              "video_url": null,
              "duration_s": null,
              "image_urls": [],
              "aspect_ratio": null,
              "author_avatar_url": null,
              "favicon_url": null
            },
            "container": "r/airpods",
            "local_relevance": 0.5208333333333333,
            "freshness": 84,
            "engagement_score": 0,
            "source_quality": 0.6,
            "local_rank_score": 0.5485416666666666
          }
        ],
        "enrichable": true
      }
    },
    "clusters": [
      {
        "cluster_id": "cluster-1",
        "title": "Do Airpods Pro 3 really have terrible battery life?",
        "candidate_ids": [
          "https://reddit.com/r/airpodspro/comments/1w63726/do_airpods_pro_3_really_have_terrible_battery_life",
          "hackernews:29185994"
        ],
        "representative_ids": [
          "https://reddit.com/r/airpodspro/comments/1w63726/do_airpods_pro_3_really_have_terrible_battery_life",
          "hackernews:29185994"
        ],
        "sources": [
          "hackernews",
          "reddit"
        ],
        "score": 16.393442622950822,
        "uncertainty": "thin-evidence"
      },
      {
        "cluster_id": "cluster-3",
        "title": "Worst experience in my life with AirPods Pro 3",
        "candidate_ids": [
          "https://reddit.com/r/airpods/comments/1ws7b1y/worst_experience_in_my_life_with_airpods_pro_3"
        ],
        "representative_ids": [
          "https://reddit.com/r/airpods/comments/1ws7b1y/worst_experience_in_my_life_with_airpods_pro_3"
        ],
        "sources": [
          "reddit"
        ],
        "score": 16.129032258064516,
        "uncertainty": "single-source"
      }
    ],
    "computed": {
      "question_share": 0.5,
      "question_share_method": "Sample comment text (redacted).",
      "stance_split": {
        "positive": 0,
        "negative": 1,
        "neutral": 0
      },
      "stance_coverage": {
        "threads": 10,
        "counted": 4,
        "no_opinion": 3,
        "uncertain": 3,
        "unjudged": 0
      },
      "top_communities": [
        {
          "container": "r/airpods",
          "thread_count": 5
        },
        {
          "container": "Hacker News",
          "thread_count": 3
        }
      ]
    },
    "legs": [
      {
        "endpoint": "/v1/hackernews/search",
        "status": 200,
        "credits_used": 1,
        "latency_ms": 576,
        "error": null
      },
      {
        "endpoint": "/v1/naver/kin/search",
        "status": 200,
        "credits_used": 0,
        "latency_ms": 1713,
        "error": null
      }
    ],
    "sources_called": [
      "hackernews",
      "naver_kin"
    ],
    "sources_succeeded": [
      "hackernews",
      "naver_kin"
    ],
    "coverage": 1,
    "partial_failure": false,
    "methodology_version": "search-forums/1.1",
    "relevance": {
      "mode": "default",
      "threshold": 0.5,
      "threads": 10,
      "scored": 10,
      "kept": 10,
      "dropped": 0,
      "dropped_ids": [],
      "unjudged": 0,
      "too_short": 0,
      "reordered": false,
      "methodology_version": "search-forums-relevance/1"
    },
    "dropped": 0
  },
  "credits_used": 10,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 10
  },
  "credits_remaining": 9999,
  "source": "captured",
  "captured_at": "2026-10-02T12:48:25.920Z",
  "redacted": true
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

Universal Search Forums API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

Universal Search Forums 데이터는 왜 SocialCrawl로 가져올까요

Universal Search 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 69개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 69개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.

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"
    }
  }
}
+ 69개 플랫폼
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
SocialCrawl 포럼 검색 API가 뭔가요?
GET /v1/search/forums는 검색어 하나를 레딧, 해커뉴스, 네이버 지식iN·카페에서 동시에 찾아서 순위가 매겨진 스레드 목록 하나로 합쳐 줘요. 상위 스레드에는 인기 댓글이 바로 붙어 와서 제목뿐 아니라 실제 대화까지 읽을 수 있어요.
어떤 포럼을 검색하나요?
기본으로 레딧, 해커뉴스, 네이버 지식iN·카페를 검색해요. 선택값인 sources로 검색 범위를 좁히고 exclude로 특정 출처를 뺄 수 있어서, 원하는 커뮤니티만 골라 검색할 수 있어요.
요금은 얼마인가요?
한 번 호출에 10 크레딧이에요. 여러 포럼 출처를 동시에 돌려요. 새 계정은 신용카드 없이 100 크레딧을 무료로 받고, 합친 검색 결과가 하나도 없으면 크레딧을 자동으로 돌려드려요.
기간과 댓글을 조절할 수 있나요?
네. timeframe과 lookback_days로 얼마나 지난 스레드까지 가져올지 정하고, comments로 상위 스레드의 인기 댓글을 붙일지 끌지 정할 수 있어요. 댓글을 끄면 더 가볍고 빠른 목록으로 와요.
포럼을 하나씩 호출하는 것과 뭐가 다른가요?
레딧, 해커뉴스, 네이버 연동을 따로 관리하지 않고 검색어 하나만 보내면 돼요. 결과는 여러 출처에 걸쳐 이미 순위가 매겨지고 합쳐진 채로 와요. 서구와 한국 커뮤니티에서 한 주제가 어디서 오가는지 한 번에 보는 가장 빠른 방법이에요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

Universal Search Forums 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 Universal Search 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요