Skip to main content
GET
Topic 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

topic
string
required

Topic ID

country
string
default:US

Country code

language
string
default:en

Language code

date
string<date>

Date filter

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