查询语法
了解查询语法，以便有效地搜索新闻文章。
AllNewsAPI 支持强大的查询语法，让您能够精准地搜索新闻文章。了解如何使用运算符来优化您的搜索。
信息
- 始终对查询字符串进行 URL 编码
- 特殊字符请用引号括起来。
- 组合运算符以获得精确结果
基本搜索
最简单的搜索方式是提供关键词。API 将返回包含这些关键词的文章。
基本搜索
提示
词项中的连字符（例如
covid-19 ）会被视为字面字符，而不是否定字符。要排除某个词项，请使用NOT运算符。短语搜索
使用引号搜索确切短语。这样可以确保单词按指定顺序一起显示。
短语搜索
与运算符
默认情况下，单词之间的空格充当AND运算符。您也可以显式使用AND 。
与运算符
手术室操作员
使用OR来匹配包含任一术语的文章。要控制优先级，请用括号将术语分组，例如iphone AND (13 OR 14) 。
手术室操作员
非操作员
使用NOT可以排除包含特定词语的文章。
非操作员
组合运算符
您可以组合使用运算符来创建复杂的查询。使用括号来控制优先级。
联合运营商
AI过滤
AI 过滤器（例如ai_sentiment 、 ai_entity_name和ai_entity_type是独立的查询字符串参数，而不是q内部的运算符。将它们与q一起添加到请求 URL 中，即可按情感、实体名称或实体类型缩小结果范围。
情感过滤器
组合式人工智能过滤器
实体名称筛选器
不支持的运营商
警告
为了安全起见，一些高级 Lucene 功能被有意禁用，如果包含在
q中则会被忽略：字段作用域（ field:value ）、正则表达式（ /.../ ）、通配符（ *和? ）、模糊搜索和邻近搜索（ ~ ）、提升（ ^ ）和范围语法（ [a TO b] ）。有效查询示例
| 询问 | 预期结果 |
|---|---|
google | 包含“谷歌”一词的新闻文章 |
google OR android | 包含“谷歌”或“安卓”字样的新闻文章 |
"google android" | 新闻文章中，以完全相同的顺序出现“google android”一词。 |
"windows 8" AND "windows 10" | 包含“windows 8”和“windows 10”这两个词的新闻文章 |
iphone AND (13 OR 14) | 包含“iPhone”一词以及数字13或14之一的新闻文章 |
android NOT google | 包含“android”一词但不包含“google”一词的新闻文章 |
technology&ai_sentiment=positive | q=technology查询与单独的ai_sentiment=positive参数（不属于q ）相结合 |
Apple&ai_entity_type=ORG | q=Apple查询与单独的ai_entity_type=ORG参数（不属于q ）结合使用 |
climate&ai_entity_name=United Nations | q=climate查询与单独的ai_entity_name=United Nations参数（不属于q ）结合使用 |