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

query
string
required

Search query string

country
string
default:us

Country code (e.g., us, gb)

language
string
default:en

Language code (e.g., en, fr)

publisher
string

Filter by publisher domain

from
string<date>

Published date from (YYYY-MM-DD)

to
string<date>

Published date to (YYYY-MM-DD)

Response

Successful search results

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.