Bonai News API: A Developer's Guide to News Search

What is the Bonai News API?

The Bonai News API is a REST API that gives developers programmatic access to a news search engine covering over 100,000 sources in 25+ languages. Unlike general-purpose search APIs, it is purpose-built for news data: article search, trending topics, publisher lookup, full-text extraction, and automatic translation of non-English articles into English.

Key Features

• Article Search: Search by keyword across 100,000+ sources with filters for language, date, category, and publisher.
• Trending Topics: Get the most-discussed stories right now, updated continuously.
• Full-Text Extraction: Retrieve the complete body text of articles, not just headlines and snippets.
• Publisher Lookup: Find all articles from a specific news source.
• Auto-Translation: Non-English articles include an English translation in every response.*
• Structured JSON: Clean, predictable response format with title, content, author, date, keywords, and publisher info.

Getting Started

To start using the Bonai News API, create a free account at bonai.io and generate an API key from the console. Your key gives you access to the free tier immediately, no credit card required.

Example Request

curl -X GET "https://api.bonai.io/news/search/articles?query=artificial+intelligence&language=en" \
  -H "api-key: YOUR_API_KEY" \
  -H "api-version: 2026-08-01"

Example Response

{
  "metadata": {
    "id": "b1037b3b-ce89-4c7e-b540-b2ecb44c3c0f",
    "took_ms": 448,
    "timestamp": "2026-10-13T15:19:53.542Z"
  },
  "parameters": {
    "query": "artificial intelligence",
    "language": "en",
    "paywall": false,
    "page": 1,
    "limit": 25,
    "sort": "relevance"
  },
  "articles": [
    {
      "id": "a53fa77ebd1ca2de7702abab8a75b0d3",
      "title": "Stock markets hit record highs as earnings beat expectations",
      "url": "https://www.marketwatch.com/markets-record",
      "excerpt": "Major indexes closed at all-time highs after a wave of better-than-expected corporate earnings and cooling inflation data.",
      "thumbnail": "https://www.marketwatch.com/images/markets-record.jpg",
      "language": "en",
      "paywall": false,
      "content_length": 4520,
      "date": "2025-07-21T14:30:00+00:00",
      "authors": ["Alice Morgan"],
      "keywords": ["Markets", "Earnings", "Stocks"],
      "translations": null,
      "publisher": {
        "name": "MarketWatch",
        "url": "https://www.marketwatch.com",
        "favicon": "https://www.marketwatch.com/favicon.ico"
      }
    }
  ],
  "pagination": {
    "total_hits": 1523,
    "page": 1,
    "hits_per_page": 25,
    "total_pages": 61,
    "has_more": true
  }
}

Response Fields

Field	Type	Description
metadata.id	string	Unique ID for the request
metadata.took_ms	number	Response time in milliseconds
metadata.timestamp	string	Time the response was generated
parameters	object	Echo of the query parameters you sent
articles	array	Array of article objects
pagination.total_hits	number	Total matching articles
pagination.page	number	Current page (1-indexed)
pagination.hits_per_page	number	Results per page
pagination.total_pages	number	Total available pages
pagination.has_more	boolean	Whether another page is available

Each article in articles includes: id, title, url, excerpt, thumbnail, language, paywall, content_length, date, authors, keywords, translations (the English translation, or null), and publisher (with name, url, favicon).

Endpoints

• GET /search/articles - keyword search with filters
• GET /trendings - trending by topic and country
• GET /search/publishers - publisher lookup
• GET /article - full article body by URL
• GET /article/random - random article
• GET /info/topics - list available topics
• GET /info/countries - list available countries
• GET /info/languages - list available languages

Pricing

The Bonai News API offers a free tier for testing and development, with paid plans that scale with your usage. Each plan includes a set number of requests per month, with overage billing at a published flat rate. Visit the pricing page for current plan details.

How is this different from Google News API?

The Bonai News API is our own independent news engine. We crawl 100,000+ sources directly and offer features like full article content and English translations. The Google News API gives you what Google News itself shows: the same topics, the same headlines, the same coverage. Use Bonai News API when you need full article text. Use Google News API when you want Google’s take on the news.

Frequently Asked Questions

What is the Bonai News API?

Bonai News API is a REST API that lets you search, filter, and read news articles from over 100,000 sources in 25+ languages. You can search by keyword, browse trending topics, get full article content, and look up publisher details.

How much does the Bonai News API cost?

Bonai News API offers a free tier for testing, with paid plans starting at a competitive monthly rate. Each plan includes a set number of requests per month, with overage billing at a published flat rate.

Can I try the Bonai News API for free?

Yes. You can create a free account and get an API key to start making requests right away. No credit card is required for the free tier.

Next Steps

Ready to start building? Create a free API key and make your first request in minutes. Check out the quickstart guide for step-by-step instructions, or try the live playground to test the API without writing code.

*Translations cover the title and excerpt (snippet) only — the full article body is not translated.