Financial data is informational and may be inaccurate. See Disclaimer.

drillr.ai
API keys →

Signal

TOOLnews_search

Semantic search over company and market news — storylines, the events inside them, and attributed statements.

Coverage
US / CN / JP
Billing
Per call · 0.2 cr / call

Input parameters

ParameterTypeRequiredDescription
querystringoptionalSemantic query, in English. At least one of query, theme, ticker, since or until is required.
themestringoptionalA theme word, resolved to the nearest canonical theme. Not valid with search_type=claims.
tickerstring | string[]optionalExact symbol(s): one symbol, an array, or a comma-separated string; several act as an OR filter. US bare (AAPL), A-shares .SH / .SZ (600519.SH), Japan .T (7203.T). Names are not resolved here — use ticker_lookup first.
sincestringoptionalISO 8601. Keeps events with time_event on or after this instant.
untilstringoptionalISO 8601. Keeps events with time_event before this instant.
search_typestringoptionalall, events, or claims — attributed statements only. Default all.
order_bystringoptionalrelevance, event_time (newest event first) or create_time (most recently ingested first). Default relevance.
top_kintoptionalStory count, max 50. Default 10.

Example

Arguments
{ "ticker": "NVDA", "query": "export controls", "top_k": 2 }
Response
query=export controls | ticker=NVDA | count=2

## Stories
1. **US Tightens AI Chip Export Curbs on China** · 48 nodes · 2026-05-30T23:59:59Z → 2026-08-31T07:05:38Z
   The US is expanding restrictions on China's AI chip access by limiting remote use and investigating smuggling, while Nvidia re-enters the Chinese market and Taiwan indicts nine for illegal exports.
2. **Nvidia, Samsung, SK Hynix Expand HBM Deals** · 36 nodes · 2026-06-01T10:57:00Z → 2026-09-02T06:30:00Z
   Nvidia is deepening ties with Samsung and SK Hynix through long-term supply agreements and advanced HBM4E development.

## Events   (`story` = the numbered story above)
| story | event_time | summary | type | entity | score | sources | source | source_url |
|---|---|---|---|---|---|---|---|---|
| 1 | 2026-05-31T20:09:53Z | The U.S. Department of Commerce moved to close a loophole that may have allowed exports of advanced AI chips … to Chinese entities located outside China. | regulatory_action | U.S. Department of Commerce | 5 | 6 | reuters.com | https://www.reuters.com/… |

## Claims
| event_time | type | claimant | target | summary | sources | source |
|---|---|---|---|---|---|---|
| 2026-06-28T23:59:59Z | corporate_disclosure | Jensen Huang | Nvidia | Nvidia CEO Jensen Huang stated that before export controls, Nvidia had about 95% market share in China … | 4 | mynorthwest.com |

Trimmed: One event and one claim shown of the twenty-odd returned; some table columns dropped.

Limits

LimitValuePast it
top_k (stories)1–50, default 10
Response size52 KB (~20k tokens)Lowest-ranked stories dropped; header says how many
Claims by themeNot supportedClaims block skipped, header says so

Errors

Invalid arguments are refused before the tool runs; the rest arrive as a tool failure whose text is the message. The four shapes are on MCP server.

WhenYou getDo
No query, theme, ticker, since or untilUpstream 400 passed throughAdd at least one filter
Unknown ticker"No results." with count=0Resolve with ticker_lookup first
top_k, search_type or order_by out of rangeInvalid argumentsUse the listed values

Notes

  • Three sections come back: Stories (each storyline once), Events (flat, with a story column pointing back), and Claims (analyst actions, corporate guidance, official remarks). sources counts corroborating reports.
  • Lowest-ranked stories are dropped to fit the response budget; the header line says how many were omitted.

Endpoint, client setup and billing are common to all tools. For details, please refer to MCP server.