Count articles over time
count_articlesCount exact news articles over time for up to five boolean queries, producing daily, weekly, or monthly timelines and share-of-voice comparisons for trend and spike analysis.
Instructions
Exact article counts over time for 1–5 boolean queries: a daily, weekly or monthly timeline of news volume, and share of voice between queries (companies, brands, topics). Use it for trends, spikes, "is coverage rising", comparing competitors, or charting attention around an event. Each bucket × query is one 5-credit call (at most 60 calls), so a 30-day daily timeline for 2 queries is 60 calls / 300 credits and takes about a minute.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"queries": "<queries>",
"from": "<from>"
},
"name": "count_articles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End of the period: ISO date or "today"/"yesterday" (default: now). | |
| from | Yes | Start of the period: ISO date ("2026-09-01") or relative ("14d", "30 days ago"); up to 12 months back. | |
| format | No | text (default, compact) or json (machine-readable). | text |
| queries | Yes | 1 to 5 boolean queries to count (same syntax as list_articles), e.g. ["Tesla", "Rivian", "Lucid"] for share of voice. | |
| sources | No | Only these publishers: domains, e.g. ["reuters.com","ft.com"]. | |
| interval | No | Bucket size: day (default), week or month. | day |
| countries | No | Only publishers from these countries: ISO 3166-1 alpha-2 codes, e.g. ["US","GB"]. | |
| languages | No | Only these languages: ISO 639-1 codes, e.g. ["en","de"]. | |
| search_in | No | Where queries are matched (default title_body). Use ["title"] to count only headline mentions. | |
| exclude_sources | No | Leave out these publishers (domains). | |
| exclude_countries | No | Leave out publishers from these countries (ISO 3166-1 alpha-2). | |
| exclude_languages | No | Leave out these languages (ISO 639-1). | |
| exclude_duplicates | No | Leave out syndicated copies. |