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-05-25).

Available options:
2026-05-25,
2024-01-01,
2022-01-01

Query Parameters

country
string
default:US
required

Country code

language
string
default:en

Language code

pageSize
integer
default:10

Number of results per page

Required range: x <= 150
page
integer
default:1

Page number

Response

Successful response

success
boolean
required
Example:

true

totalHits
integer
required

Total number of matching items

size
integer
required

Number of results in this page

pageSize
integer
required

Maximum items per page

page
integer
required

Current page number

totalPages
integer
required

Total number of pages

articles
object[]
required