Skip to main content
GET
News topics
Polymorphic response. news_articles items vary by typearticle, story, storyline, or social_post.

Authorizations

api-key
string
header
required

Your Bonai API key. Create one in the Bonai console (https://console.bonai.io).

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_id
string
required

Topic ID (e.g., TECHNOLOGY, BUSINESS or CAAq...)

subtopic_id
string

Subtopic ID (CAAq...)

country
string
default:US
language
string
default:en

Response

Successful topic headlines

metadata
object
required
parameters
object
required

The query parameters used for this request

news_articles
object[]
required

Polymorphic list. Each item's type is article, story, storyline, or social_post.

title
string