Top headlines and news search via GNews. Requires an operator-provided API key — contact support to enable access.
https://api.apiclearinghouse.com/v1/call/newsAuthenticate with X-Api-Key: chk_live_... header.
/top| Name | Type | Required | Description |
|---|---|---|---|
| max | number | optional | Max articles (1-10)(default: 5) |
| lang | string | optional | Language code(default: en) |
| category | string | optional | News category (general, world, nation, business, technology, entertainment, sports, science, health) |
curl -s "https://api.apiclearinghouse.com/v1/call/news/top?max=5&lang=en&category={category}" \
-H "X-Api-Key: YOUR_API_KEY"{
"status": "success",
"data": {
"total": "example",
"articles": "example"
}
}/search| Name | Type | Required | Description |
|---|---|---|---|
| q | string | required | Search query |
| max | number | optional | Max articles(default: 5) |
curl -s "https://api.apiclearinghouse.com/v1/call/news/search?q={q}&max=5" \
-H "X-Api-Key: YOUR_API_KEY"{
"status": "success",
"data": {
"total": "example",
"articles": "example"
}
}Monthly limits also apply per plan.