Skip to main content
GET
Search articles

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

query
string
required

Search query string

Minimum string length: 1
language
string

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

country
string

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

publisher
string<uri>

Publisher URL to filter by

paywall
enum<string>

Filter by paywall status

Available options:
true,
false
from
string

Start date for date range filter

to
string

End date for date range filter

page
integer
default:1

Page number

Required range: x >= 1
limit
integer
default:25

Number of results per page

Required range: 1 <= x <= 1000
sort
enum<string>

Sort order

Available options:
relevance,
date

Response

Successful response

parameters
object
required

The query parameters used for this request

articles
object[]
required