Search news
news_search_articlesRead-onlyIdempotent
Search the article corpus, newest first, same row shape as news_get_feed. Words in q are ANDed; commas, semicolons, | or OR separate alternatives; a quoted q is one exact phrase; ticker symbols such as RELIANCE.NS match the company. Free; takes the same filters as the feed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search text. | |
| days | No | Only the last N days; never past the plan's news history window. | |
| limit | No | Default 100. | |
| region | No | Comma-separated feed regions, e.g. US, IN, UK, EU, GLOBAL. | |
| source | No | Comma-separated feed ids as news_list_sources lists them. | |
| category | No | Comma-separated categories: markets, economy, regulatory, geopolitics, crypto, commodities, corporate. corporate (exchange and EDGAR filings) is left out unless a category or source is named. | |
| per_source | No | Up to N rows from each feed ahead of the rest, so one busy feed cannot fill the page. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| meta | No | ||
| tool | Yes | ||
| error | No | ||
| blocks | No | ||
| status | Yes | ||
| fincept | Yes | ||
| summary | No | ||
| warnings | No | ||
| artifacts | No | ||
| truncated | No |