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

## GET /v1/hackernews/search
Search Hacker News
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term.
- tags (optional, string) — Algolia tag filter — comma-separated. Common values: "story", "comment", "poll", "show_hn", "ask_hn", "front_page", "author_<username>". Defaults to "story".
- numericFilters (optional, string) — Algolia numeric filter expression on `created_at_i` (the only filterable numeric attribute) — e.g. "created_at_i>1700000000". Combine with commas for AND. No filter is applied by default.
- hitsPerPage (optional, integer) — Hits per page (1–1000). Defaults to 30.
- page (optional, integer) — 0-indexed page number for pagination.
curl "https://www.socialcrawl.dev/v1/hackernews/search?query=claude code" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/hackernews/story
Get a Hacker News story
Credit cost: 1 (standard)
Parameters:
- id (required) — HN story id (the numeric `objectID`).
curl "https://www.socialcrawl.dev/v1/hackernews/story?id=8863" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/hackernews/story/comments
Get comments on a Hacker News story
Credit cost: 1 (standard)
Parameters:
- id (required) — HN story id (the numeric `objectID`).
curl "https://www.socialcrawl.dev/v1/hackernews/story/comments?id=8863" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/hackernews/profile
Get a Hacker News user profile
Credit cost: 1 (standard)
Parameters:
- handle (required) — Hacker News username (case-sensitive, e.g. `pg` or `kogir`).
curl "https://www.socialcrawl.dev/v1/hackernews/profile?handle=pg" \
  -H "x-api-key: sc_your_api_key_here"