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

## GET /v1/google_news/search
Search Google News
Credit cost: 1 (standard)
Parameters:
- keyword (required) — Search query (e.g. 'openai'). Supports any language; pass the matching language_code. Advanced operators (site:, intitle:, cache:, …) are not supported.
- depth (optional, integer) — Number of articles to retrieve (default 10, multiples of 10, max 100). No pagination beyond depth.
- location_code (optional, integer) — Google location code (e.g. 2840 = United States). Use one of location_code / location_name / location_coordinate.
- location_name (optional, string) — Google location name (e.g. 'South Korea').
- location_coordinate (optional, string) — GPS target as 'latitude,longitude,radius_mm' (e.g. '40.7128,-74.0060,200') for local-news radius queries.
- language_code (optional, string) — Google language code (e.g. 'en', 'ko'). Default 'en'.
- time_range (optional, enum: hour | day | week | month | year) — Only return articles published within this window: hour, day, week, month, or year. Ignored when from/to is present.
- publisher (optional, string) — Limit results to a single outlet's domain (e.g. 'bbc.com'). Bare domain only — no scheme, no path. Not combinable with location_coordinate or time_range=hour.
- from (optional, string) — Start of an exact publish-date window, as YYYY-MM-DD or a Unix timestamp. Overrides time_range. Not combinable with location_coordinate or time_range=hour.
- to (optional, string) — End of the publish-date window (inclusive), as YYYY-MM-DD or a Unix timestamp. Defaults to now when only from is set.
curl "https://www.socialcrawl.dev/v1/google_news/search?keyword=openai" \
  -H "x-api-key: sc_your_api_key_here"