Headers
Get your API keyAPI key (`sfk_...`)
Full-text search query. Required unless `frontPageOnly`, `author`, `domain`, or `url` is set.
max 512 chars
Content type filter. Default: `all`.
one of: all, story, comment, ask_hn, show_hn, launch_hn, job, poll
Ranking mode. Default: `popularity`.
one of: popularity, date
Creation-time window. Default: `all`.
one of: 24h, week, month, year, all
Zero-based page index (maximum 50 pages, up to 1,000 hits).
≥ 0 · ≤ 49
Hits per page. Default: 20.
When true, restrict results to current front-page items. Allows omitting `query`.
Include story/comment text in searchable fields. Default: true. Set false to search title/URL only.
When true, include author username in the searchable fields.
When true, enable prefix matching for query tokens.
Enable typo tolerance. Default: true.
Restrict results to items by this Hacker News username.
min 1 chars · max 255 chars · pattern: ^[A-Za-z0-9_-]+$
Restrict search to story URLs matching this domain (e.g. example.com). Can omit `query`.
min 1 chars · max 255 chars
Restrict search to story URLs matching this URL substring. Can omit `query`.
min 1 chars · max 2048 chars
Minimum points/score filter.
≥ 0 · ≤ 1000000
Endpoint-specific response payload.
Search query evaluated for this response, or null for front-page-only.
Search hits for this page.
Hacker News item id.
≥ 0
Normalized content type.
one of: story, comment, poll, job, pollopt, unknown
Author username when present.
Creation time as an ISO-8601 timestamp.
Plain-text title when present.
Plain-text body when present (HTML stripped).
External story URL when present and publicly safe.
Points / score when present.
Comment count for stories when present.
Parent story id for comment hits when present.
≥ 0
Immediate parent item id when present.
≥ 0
Normalized content tags for this hit (e.g. story, ask_hn).
min 1 chars
Canonical news.ycombinator.com item URL.
Pagination information for the current response.
Zero-based page index for this response.
≥ 0
Requested page size for this response.
≥ 0
Number of hits returned in this response.
≥ 0
Whether another page of results is available.
Next page index when hasMore is true; otherwise null.
≥ 0
Reported total hit count from the search index.
≥ 0
Whether totalHits is exhaustive. When false, treat totalHits as an estimate.
Hard upper bound on pageable hits from the search index (typically 1000).
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/hackernews/search?query=Dropbox" \
-H "x-api-key: YOUR_API_KEY"Responses
Hacker News search results.