InsightSocial
GET /v1/hackernews/searchbeta

Hacker News Search API

Search Hacker News by keyword.

20 credits a call · cursor pagination · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/hackernews/search" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "hackernews",
"endpoint": "/v1/hackernews/search",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"pagination": {
"next_cursor": "<string | null>",
"has_more": "<boolean>"
},
"unavailable": [],
"credits_used": "<integer>"
}

Parameters

Query parameters for GET /v1/hackernews/search. Send your key in the x-api-key header.

NameRequiredDescription
queryNoFull-text search query. Required unless front_page_only, author, domain, or url is set.
typeNoRestrict search results to a Hacker News content type. ask_hn: Ask HN posts (questions to the community). show_hn: Show HN posts (projects/work being shared). launch_hn: Launch HN posts (YC-affiliated company launches). Default: all.
sortNoRanking mode. Default: popularity.
date_rangeNoCreation-time window. Default: all.
limitNoHits per page. Must be one of 10, 20, 30, 50. Default: 20.
front_page_onlyNoWhen true, restrict results to current front-page items. Allows omitting query.
search_story_textNoInclude story/comment text in searchable fields. Default: true. Set false to search title/URL only.
search_authorNoWhen true, include author username in the searchable fields.
prefixNoWhen true, enable prefix matching for query tokens.
typo_toleranceNoEnable typo tolerance. Default: true.
authorNoRestrict results to items by this Hacker News username.
domainNoRestrict search to story URLs matching this domain (e.g. example.com). Can omit query.
urlNoRestrict search to story URLs matching this URL substring. Can omit query.
min_pointsNoMinimum points/score filter.
cursorNoPass pagination.next_cursor from the previous response to get the next page. Keep the other parameters the same.

Response

This endpoint is beta: data holds the platform's own fields under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a unified post or profile, and those fields may change.

Every field, error and example is in the Hacker News Search API reference.

How much does the Hacker News Search API cost?

20 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Hacker News Search API: frequently asked questions

Send GET /v1/hackernews/search with its query parameters and your key in the x-api-key header. Search Hacker News by keyword.