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

## GET /v1/google_trends/explore
Get Google Trends interest over time
Credit cost: 5 (advanced)
Parameters:
- keywords (required) — 1-5 comma-separated keywords (e.g. 'reverse audio,voice changer'). With multiple keywords the 0-100 values are normalised across the set for direct comparison.
- location (optional, string) — Location as a DFS name ('United States') or numeric code ('2840'). Defaults to worldwide-leaning US.
- timeframe (optional, enum: past_hour | past_4_hours | past_day | past_7_days | past_30_days | past_90_days | past_12_months | past_5_years) — Preset time window: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, or past_5_years. Defaults to past_12_months.
- category (optional, integer) — Numeric Google Trends category code to scope the query (default 0 = all categories).
curl "https://www.socialcrawl.dev/v1/google_trends/explore?keywords=uv index" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google_trends/rising
Get related + rising Google Trends queries
Credit cost: 5 (advanced)
Parameters:
- keyword (required) — Single keyword to expand (e.g. 'uv index'). Google Trends returns the related-queries list for one keyword only.
- location (optional, string) — Location as a DFS name ('United States') or numeric code ('2840'). Defaults to worldwide-leaning US.
- timeframe (optional, enum: past_hour | past_4_hours | past_day | past_7_days | past_30_days | past_90_days | past_12_months | past_5_years) — Preset time window: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, or past_5_years. Defaults to past_12_months.
curl "https://www.socialcrawl.dev/v1/google_trends/rising?keyword=uv index" \
  -H "x-api-key: sc_your_api_key_here"