SonarBay News Intelligence#

Real-time access to 7 days of global news, updated every 15 minutes. ~100K+ articles from thousands of sources worldwide.

CLI#

The primary way to access SonarBay.

Install#

bash

# Mac/Linux
curl -fsSL https://sonarbay.com/install.sh | sh

# Windows (PowerShell)
irm https://sonarbay.com/install.ps1 | iex

Search News#

bash

sonarbay search "AI regulation"
sonarbay search "climate change" -n 20 -s newest
sonarbay search "Tesla" --country US --source reuters.com

FlagDescription-n <num>Results per page (default: 10)-p <num>Page number (default: 1)-s <sort>``relevance (default), newest, oldest``--country <code>Filter by country code (e.g. US, IN, DE)--source <domain>Filter by source domain--jsonRaw JSON output for piping

Trending Entities#

bash

sonarbay trending
sonarbay trending -t organizations -w 48h -n 10

FlagDescription-t <type>``persons (default), organizations, countries, source``-w <window>Time window: 1h, 6h, 12h, 24h (default), 48h, 7d``-n <num>Number of results (default: 20)

Time-Series Counts#

bash

sonarbay counts "bitcoin" -i 1h -w 72

FlagDescription-i <interval>Bucket size: 15m, 1h (default), 6h, 1d``-w <hours>Lookback window in hours (default: 24)

Other Commands#

bash

sonarbay status          # Health check
sonarbay update          # Self-update to latest version
sonarbay --version       # Show version

Pipe-Friendly#

Every command supports --json for scripting and piping:

bash

sonarbay search "OpenAI" --json | jq '.results[].title'
sonarbay trending --json | jq '.trending[:5]'
sonarbay counts "inflation" --json | jq '.buckets[] | select(.count > 100)'

Common Patterns#

Monitor a topic over time#

1. Run sonarbay counts "topic" -w 72 to see the trend
2. Identify spikes in the histogram
3. Run sonarbay search "topic" -s newest to find what triggered a spike

Find who's making news#

1. Run sonarbay trending -t persons or -t organizations
2. Search for a specific entity to get articles

Compare coverage across sources#

1. Search the same topic with different --source filters
2. Compare result counts and article titles

REST API (Fallback)#

If the CLI is not available, use the REST API directly.

Base URL: https://sonarbay.com

EndpointDescriptionGET /v1/search?q=<query>&per_page=10&sort=relevanceSearch articlesGET /v1/trending?type=persons&hours=24&limit=20Trending entitiesGET /v1/counts?q=<query>&interval=1h&hours=24Time-series countsGET /v1/article/<id>Single article by IDGET /v1/statusHealth check

All endpoints return JSON. No authentication required.

Data Details#

• Coverage: 7-day rolling window, ~100K+ articles
• Update frequency: Every 15 minutes
• Sources: Thousands of global news outlets
• Languages: Primarily English, with multilingual coverage
• Fields per article: title, source, url, date (ISO), countries, location names
• Country codes: ISO 2-letter (US, UK, IN, DE, etc.)