The q parameter accepts a boolean query, and it works the same on news, blogs, and forums. Terms without a field prefix are matched against the post title, text, and thread title. A space between terms means AND.
| Syntax | Example | Matches |
|---|---|---|
| Implicit AND | solar battery | Posts with both terms |
OR | solar OR wind | Either term |
NOT or - | tesla NOT car, tesla -car | First term without the second |
( ) | (solar OR wind) storage | Grouping |
"..." | "climate change" | Exact phrase |
"..."~N | "apple watch"~3 | Terms within N words of each other |
* | crypt* | Prefix wildcard |
$ | gold$ | Exact term, no stemming. Supported for English, Spanish, Arabic, Russian, and French. |
field:value | language:english | Field filter - see filters for News, Blogs, or Forums |
Company mentions, excluding job posts:
"acme corp" NOT (hiring OR "job opening")
A phrase near another term, in English news from the US:
"data breach"~5 ransomware language:english country:US
400.~N) operators per query.*word) are removed automatically - they are too expensive to run.AND, OR, NOT must be uppercase.author:"jane doe".Not sure about a query? Add warning=true to your request - potential issues come back in a warnings array without failing the request.