Quickstart - Bonai Docs

This guide gets you from zero to your first Bonai News API request. You’ll need an API key from the Bonai console. See getting started if you don’t have one yet.

Search for articles

The GET /search/articles endpoint is the fastest way to get results:

curl --request GET \
  --url "https://api.bonai.io/news/search/articles?query=technology" \
  --header "api-key: YOUR_API_KEY"

The response is paginated:

{
  "success": true,
  "size": 10,
  "totalHits": 12843,
  "hitsPerPage": 10,
  "page": 1,
  "totalPages": 1285,
  "timeMs": 42,
  "data": [
    {
      "title": "Example article title",
      "url": "https://example.com/article",
      "excerpt": "A short description of the article.",
      "thumbnail": "https://example.com/image.jpg",
      "language": "en",
      "paywall": false,
      "contentLength": 4821,
      "date": "2026-07-30T09:00:00+00:00",
      "authors": ["Jane Doe"],
      "keywords": ["technology"],
      "publisher": {
        "name": "Example Publishing",
        "url": "https://example.com",
        "favicon": "https://example.com/favicon.ico"
      }
    }
  ]
}

Refine your search

Add filters to narrow results:

curl --request GET \
  --url "https://api.bonai.io/news/search/articles?query=ai&language=en&country=us&sort=date&limit=20" \
  --header "api-key: YOUR_API_KEY"

query (required): the search text.
language: ISO language code, for example en.
country: country code, for example us.
publisher: filter by a publisher’s URL.
paywall: filter by paywall status (true or false).
from / to: date range for published articles.
sort: relevance or date.
page / limit: pagination. limit defaults to 25 and is capped by your plan.

curl --request GET \
  --url "https://api.bonai.io/news/trendings?topic=technology&language=en&country=us" \
  --header "api-key: YOUR_API_KEY"

Next steps

Explore all endpoints in the API Reference.
Understand rate limits and errors.