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 public Hacker News items by keyword.
GET https://hacker-news-search.api.whox.ai/v1/search
| Argument | Type | Required | Description |
|---|---|---|---|
| query | string | Yes |
{
"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.