Introduction

The Bindoo News API is an institutional-grade JSON interface that delivers real-time news metadata enriched with NLP insights, sentiment polarity, and stock ticker mappings.

Designed for high-frequency algorithmic trading and quant-research, our system aggregates data from 50+ global tier-1 sources into a synchronized, clean feed.

Authentication

Access to the API requires an API key. You can find your active key in your Dashboard.

Auth should be handled via the X-API-KEY HTTP header.

GET

/api/v1/news/search

Search through millions of articles with granular filters. Results are sorted by relevance and timestamp.

Request Parameters

q OPTIONAL

Keywords or phrases to search for in the article title and abstract. Wrap in double quotes for exact matches.

Example Call

GET /api/v1/news/search?q=NVIDIA

date OPTIONAL

A specific date in YYYY-MM-DD format. Overrides start_date/end_date if provided.

Example Call

GET /api/v1/news/search?date=2026-03-22

stocks PROFESSIONAL+

Comma-separated list of stock tickers (e.g., 0700.HK,AAPL).

Example Call

GET /api/v1/news/search?stocks=0700.HK

sentiment BASIC+

Filter by AI sentiment polarity. Allowed values: positive, negative, or neutral.

Example Call

GET /api/v1/news/search?sentiment=positive

entities BASIC+

Search by extracted NLP entities. Usage is restricted to 100 entity-points/day for Basic users.

Example Call

GET /api/v1/news/search?entities=AI

limit OPTIONAL

Number of results per page. Optimized for performance: must be 5, 10, or 20. Defaults to 10.

Example Call

GET /api/v1/news/search?limit=20

page OPTIONAL

Page number for pagination.

Example Call

GET /api/v1/news/search?page=2

Response Object

results

List of matching news items.

total

Total results found.

total_pages

Number of pages based on your limit.

Error Codes

Code	Message	Description
401	apiKeyMissing	Your API key was not supplied in the header.
403	apiKeyInvalid	Invalid API key or disabled account.
429	rateLimited	Usage quota exceeded for your current tier.

Tier Quotas

API limits are strictly enforced based on your subscription. Exceeding these limits will result in 429 Too Many Requests errors.

Free Tier

• 500 Daily Requests
• 5 req/sec (RPS)
• Last 90 Days History

Basic Tier

• 5,000 Daily Requests
• 20 req/sec (RPS)
• Last 2 Years History

Professional

• 50,000 Daily Requests
• 100 req/sec (RPS)
• History Since 2020

Premium

• 250,000+ Daily Requests
• 200 req/sec (RPS)
• History Since 2015

Request Example

Curl

curl -X GET \
"https://api.bindoofeed.com/api/v1/news/search?q=AI" \
-H "X-API-KEY: your_key"

Response Sample

{
  "total": 100,
  "page": 0,
  "limit": 10,
  "total_pages": 10,
  "results": [
    {
      "source": "CNBC",
      "author": "John Doe",
      "title": "NVIDIA reaches market cap high",
      "sentiment": "positive",
      "stock_codes": ["NVDA", "AI.US"],
      "summary": "AI demand drives stock...",
      "date": "2026-03-20"
    }
  ]
}

Base URL

https://api.bindoofeed.com/api/v1/