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

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

| 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.)