WHOX APIs · API directory · Agent guide

hacker-news-search API

Full OpenAPI3.1 schema · Input and output JSON schemas · Usage documentation

Anonymous public reads. GET query parameters or POST JSON; both invoke the same read-only operation.

search

Search public Hacker News items by keyword.

GET https://hacker-news-search.api.whox.ai/v1/search
ArgumentTypeRequiredDescription
querystringYes

Try this read operation

Response schema

{
  "type": "object",
  "required": [
    "ok",
    "service",
    "operation",
    "data",
    "meta"
  ],
  "properties": {
    "ok": {
      "const": true
    },
    "service": {
      "type": "string"
    },
    "operation": {
      "type": "string"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": true
      }
    },
    "meta": {
      "type": "object",
      "required": [
        "tier",
        "source",
        "durationMs",
        "cached"
      ],
      "properties": {
        "tier": {
          "const": 1
        },
        "source": {
          "type": "string",
          "format": "uri"
        },
        "durationMs": {
          "type": "number"
        },
        "cached": {
          "type": "boolean"
        },
        "ageMs": {
          "type": "number"
        },
        "definitionVersion": {
          "type": "string"
        }
      }
    }
  },
  "additionalProperties": false
}

Limits:60 requests/minute/client; source limits also apply. Cache30seconds; timeout15seconds. Errors return JSON with a code and message, using400/404/429/502/503/504. API keys, cookies and WHOX account sessions are never shared.