- name
- sonarbay-news
- description
- Search and analyze global news using SonarBay News Intelligence. Provides real-time access to 7 days of worldwide news coverage via CLI or REST API. Use when the user needs news search, trending entities, mention counts over time, or any news-related data analysis.
- metadata
- author
- sonarbay
- version
- 1.0
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 | iexSearch 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 versionPipe-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 72to see the trend - Identify spikes in the histogram
- Run
sonarbay search "topic" -s newestto find what triggered a spike
Find who's making news
- Run
sonarbay trending -t personsor-t organizations - Search for a specific entity to get articles
Compare coverage across sources
- Search the same topic with different
--sourcefilters - 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.)