Reference
Query Syntax
The query parameter of Search uses the Lucene syntax. Text fields match words and phrases without regard to case. Lists of values use OR: symbols:(AAPL OR MSFT).
Fields
| Field | Description |
|---|---|
title, description | Words and phrases. |
symbols | Ticker, for example symbols:NVDA. |
source.id, source.name | Publisher, for example source.id:prnewswire. The IDs are listed by List Sources. |
sector, industry | Sector or industry words. |
publishedAt | Dates and ranges, New York time if no offset is given. |
id, sourceUrl | Exact values. |
_exists_ | Field exists, for example _exists_:symbols. |
Operators
| Syntax | Description |
|---|---|
AND, OR, NOT | Boolean operators. Words without an operator are joined with OR. |
( ) | Grouping, also for one field: title:(merger OR acquisition). |
"…" | Phrase. |
* ? | Wildcards inside or at the end of a word. A leading wildcard is not allowed. |
[a TO b] {a TO b} | Inclusive and exclusive ranges, * for an open end. |
> >= < <= | Comparisons: publishedAt:>=2026-10-01. |
now-7d | Date math with the units y M w d h m s, rounding with /d. |
Dates
A date without an offset is New York time. A day matches the full day: publishedAt:2026-10-20. A month or a year needs a range: publishedAt:[2026-10 TO 2026-11}.