Overview - Bonai Docs

The Bonai News API is a comprehensive news aggregation and search API. It gives you access to articles, publishers, and trending topics across many languages and countries in a consistent, predictable format.

Capabilities

Search articles: full-text search across indexed articles with filters for language, country, publisher, paywall status, and date range.
Search publishers: find news publishers by name, category, country, or language.
Article content: fetch the full content of a specific article by URL or stable ID, as plain text or HTML.
Random articles: retrieve a random article for discovery and demos.
Trending topics: get the latest trending articles for a topic, language, and country.
Translations: non-English articles include per-language title and excerpt translations.
MCP server: connect the API to AI tools with the Model Context Protocol. See MCP server.

Base URL

All requests use the api.bonai.io/news base URL:

https://api.bonai.io/news

Authentication

Every request except GET /ping requires your API key, sent as a bearer token (recommended) or in the api-key / x-api-key header. Keys are product-scoped and created in the Bonai console. See authentication.

Versioning

The API uses header-based versioning with the api-version header. The latest version is 2026-08-01, which is also the default when the header is omitted. See API versions.

Response format

Responses in the latest version use a metadata / parameters / pagination / resource envelope:

{
  "metadata": {
    "id": "uuid",
    "took_ms": 42,
    "timestamp": "2026-08-01T09:00:00Z"
  },
  "parameters": {
    "query": "technology"
  },
  "pagination": {
    "total_hits": 12843,
    "page": 1,
    "hits_per_page": 10,
    "total_pages": 1285,
    "has_more": true
  },
  "articles": []
}

Each endpoint names its results with a resource key: articles, article, publishers, topics, countries, or languages. Errors use a metadata + errors envelope. See errors.

Older API versions (2024-01-01) use a different envelope: { success, size, totalHits, ..., data } with camelCase field names. See API versions.

Next steps

Quickstart: make your first request.
API versions: how versioning works.
MCP server: connect AI tools to the API.
API Reference: explore every endpoint interactively.

​Capabilities

​Base URL

​Authentication

​Versioning

​Response format

​Next steps

Capabilities

Base URL

Authentication

Versioning

Response format

Next steps