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

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

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

Search News

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

Flag	Description
`-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
`--json`	Raw JSON output for piping

Trending Entities

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

Flag	Description
`-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

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

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

Other Commands

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:

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

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

Find who's making news

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

Compare coverage across sources

Search the same topic with different --source filters
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

Endpoint	Description
`GET /v1/search?q=<query>&per_page=10&sort=relevance`	Search articles
`GET /v1/trending?type=persons&hours=24&limit=20`	Trending entities
`GET /v1/counts?q=<query>&interval=1h&hours=24`	Time-series counts
`GET /v1/article/<id>`	Single article by ID
`GET /v1/status`	Health 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.)

sonarbay-news

Safety Notice

Copy this and send it to your AI assistant to learn