Search Hacker News posts | SociallisteningAPI

Search Hacker News stories and comments by keyword, newest first, and return normalized content, engagement, and source data.

Endpoint

Path: /api/v1/hackernews/search
Cost: 1 credit per successful request

Query parameters

Name	Required	Description	Example
`query`	Yes	The keyword or phrase to search for.	`social listening`
`raw`	No	Include the unchanged provider response in the raw field. Defaults to false.	`true`

curl --get 'https://api.sociallisteningapi.com/api/v1/hackernews/search' \
  --data-urlencode 'query=social listening' \
  --data-urlencode 'raw=true' \
  --header 'x-api-key: YOUR_API_KEY'

Responses

{
  "success": true,
  "platform": "hackernews",
  "endpoint": "/api/v1/hackernews/search",
  "data": {
    "items": [
      {
        "id": "41234567",
        "platform": "hackernews",
        "url": "https://news.ycombinator.com/item?id=41234567",
        "content": {
          "title": "Show HN: A social listening API",
          "text": "A practical guide to social listening for small teams.",
          "media_urls": [],
          "thumbnail_url": null
        },
        "author": {
          "id": "alex",
          "username": "alex",
          "display_name": "alex",
          "avatar_url": null,
          "verified": null
        },
        "engagement": {
          "views": 1200,
          "likes": 48,
          "comments": 7,
          "shares": 3,
          "saves": null
        },
        "published_at": "2026-08-05T01:30:00.000Z",
        "ext": {
          "story_id": "41234567"
        }
      }
    ]
  },
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 1
  },
  "raw": {
    "hits": []
  },
  "request_id": "req_example123",
  "credits_used": 1,
  "credits_remaining": 99
}