# SocialCrawl API — search endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/search

## GET /v1/search/everywhere
Universal social search across 12 platforms
Credit cost: 20 (override; tier standard)
Parameters:
- query (required) — Search query (1–512 chars)
- lookback_days (optional, integer) — Days to look back (1–365+, default 30); mutually exclusive with from_date/to_date.
- from_date (optional, string) — ISO YYYY-MM-DD lower bound; mutually exclusive with lookback_days.
- to_date (optional, string) — ISO YYYY-MM-DD upper bound; defaults to today when from_date is set alone.
- sources (optional, string) — Optional CSV allowlist of source names (mutually exclusive with exclude).
- exclude (optional, string) — Optional CSV blocklist of source names (mutually exclusive with sources).
curl "https://www.socialcrawl.dev/v1/search/everywhere?query=kanye west" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/search/forums
Fused forum search across Reddit, Hacker News, and Naver 지식iN/카페 — with top comments inline on hero threads by default.
Credit cost: 10 (override; tier standard)
Parameters:
- query (required) — Search query (2–256 chars), forwarded to every forum search.
- sources (optional, string) — Optional CSV allowlist of forum sources (reddit, hackernews, naver_kin, naver_cafe). Mutually exclusive with exclude.
- exclude (optional, string) — Optional CSV blocklist of forum sources. Mutually exclusive with sources.
- comments (optional, string) — Comment enrichment toggle (on|off, default on). 'off' returns thread-only.
- timeframe (optional, string) — Recency window passed to Reddit; HN filtered client-side (all|day|week|month|year, default all).
- lookback_days (optional, integer) — Alt recency window in days (1–365); HN filtered client-side.
curl "https://www.socialcrawl.dev/v1/search/forums?query=airpods pro 3 battery" \
  -H "x-api-key: sc_your_api_key_here"