Skip to main content
GET
Top headlines

Authorizations

Authorization
string
header
required

Your Bonai API key, sent as Authorization: Bearer <key>. The api-key and x-api-key headers are also accepted.

Headers

api-version
enum<string>

API version to consume. Defaults to the latest version (2026-08-01).

Available options:
2026-08-01,
2024-01-01,
2022-01-01

Query Parameters

country
string
required

Country code (e.g., 'us', 'uk')

language
string
default:en

Language code (e.g., 'en', 'es')

pageSize
integer
default:25

Number of results per page

Required range: 1 <= x <= 100
category
string

Category filter

sortBy
string

Sort order

Response

Successful response

status
string
required
Example:

"ok"

totalResults
integer
required

Total number of matching items

articles
object[]
required