List matching articles
list_articlesLists every article matching a boolean query over the last 12 months, newest first, with exact counts, paging, and tallies by outlet, author, country or language.
Instructions
List EVERY article that matches a boolean query over the last 12 months, newest first, with an exact total count, paged (up to 1,000 per query). Use it for completeness and counting: "how many articles mention X", "all coverage of Y since October", older news beyond 30 days, monitoring checklists, exports. tally counts matches by outlet, author, country or language (who covers a topic). Precise keyword/boolean matching, not relevance ranking: for the best answers to a question use search_news. 5 credits per call.
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": {
"query": "<query>"
},
"name": "list_articles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End: ISO date/time or phrase. Default: now. When paging, pass the window end from the first page so every page covers the same articles. | |
| from | No | Start: ISO date/time ("2026-10-01") or a phrase ("30 days ago"). Default: 7 days ago. Up to 12 months back. | |
| page | No | Page number, from 1. page × page_size can reach the first 1,000 articles of a query. | |
| sort | No | Order: newest (default), oldest, relevance, or source_rank (biggest publishers first). | newest |
| query | Yes | Boolean query: AND, OR, NOT, parentheses, "exact phrases", +must, -mustnot, wild*cards, NEAR("a", "b", 5). Example: "Nvidia" AND (earnings OR guidance) NOT "stock split". | |
| tally | No | Instead of listing, count the matching articles by outlet, author (bylines that are people), country and/or language, in one pass: e.g. ["source","country","language"]. Outlets and authors come with their latest article. Who covers a topic, media lists, coverage mix. | |
| format | No | text (default, compact) or json (machine-readable). | text |
| sources | No | Only these publishers: domains, e.g. ["reuters.com","ft.com"]. | |
| 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"]. | |
| min_words | No | Only articles with at least this many words. | |
| page_size | No | Articles per page (default 20, up to 100). | |
| search_in | No | Where the query is matched (default title_body). *_translated fields match the English translation of non-English articles. | |
| count_only | No | Return only the exact number of matching articles (no list). | |
| tally_pages | No | With tally: pages of 100 newest articles to count (default 3; 5 credits each). | |
| top_sources | No | Only the best-ranked publishers: "top <n> <country code>" or "top <n> global", e.g. "top 100 US" or "top 50 global". | |
| exclude_sources | No | Leave out these publishers (domains). | |
| max_source_rank | No | Only publishers ranked at or better than this traffic rank (1 = biggest). | |
| 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 of an article. |