Documentation

登录获取免费 API 密钥

搜索端点

使用关键词、筛选条件和高级查询语法搜索新闻文章

通过搜索功能，您可以使用关键词、短语和高级查询运算符搜索我们整个数据库中的新闻文章。您还可以按语言、国家/地区、类别、日期范围等条件筛选结果。

GEThttps://api.allnewsapi.com/search

查询参数

姓名
类型
默认值
描述
apikey必需的
string—

您的 API 密钥用于身份验证。请从控制面板获取您的 API 密钥。

q
string—

此参数允许您获取与关键词匹配的新闻文章。您的关键词有助于系统找到最适合您的文章。您可以将关键词与逻辑运算符结合使用，您可以在[此处](链接)了解更多信息。 查询语法部分

例如：
technology"artificial intelligence"apple AND iphone
startDate
string—

此参数允许您根据文章的发布日期筛选文章。您可以指定一个日期，API 将仅返回在该日期或之后发布的文章。

例如：
2024-12-15T17:48:56Z2025-05-20
endDate
string—

此参数允许您根据文章的发布日期筛选文章。您可以指定一个日期，API 将仅返回在该日期或之前发布的文章。

例如：
2024-08-14T17:48:56Z2024-01-23
content
booleanfalse

此参数允许您检索文章的完整内容。默认情况下，内容会被截断。将其设置为true可获取完整内容。

例如：
truefalse
lang
string—

此参数允许您指定 API 返回的新闻文章的语言。您可以组合多种语言，并用逗号分隔。请参阅列表。 支持的语言

例如：
enen,fr,de
country
string—

此参数允许您指定 API 返回的新闻文章的发布国家/地区。您可以用逗号分隔多个国家/地区。查看完整列表 国家及其代码

例如：
usgb,de,fr
region
string—

此参数允许您指定 API 返回的新闻文章的发布地区。您可以用逗号分隔多个地区。查看完整列表 地区

例如：
americasafrica,asia
category
string—

此参数允许您筛选按特定类别返回的新闻文章。您可以用逗号分隔多个类别。查看完整列表 支持的类别

例如：
financefood,health,hobbies,lifestyle
max
integer5

此参数允许您指定 API 在单次请求中返回的新闻文章数量。有效值介于 1 到 100 之间，具体取决于您的订阅套餐。

例如：
1020
attributes
stringtitle,description

此参数允许您选择在新闻文章的哪些部分搜索关键词。有效值包括标题、描述和内容。您可以组合多个属性，并用逗号分隔。例如， “title,description”表示同时在标题和描述中搜索。

例如：
titletitle,description,content
page
integer1

此参数允许您控制 API 返回结果的分页方式。每页显示一定数量的文章，具体数量由“max”的值决定。
例如，如果“max”设置为 10，则第一页将显示第 1 至 10 篇文章，第二页将显示第 11 至 20 篇文章，依此类推。

例如：
120
sortby
stringpublishedAt

此参数允许您选择文章的排序方式。有两种选项：
publishedAt ：此功能按文章的发布日期进行排序，最新的文章排在最前面。
相关性：此功能会根据文章与关键词的匹配程度对文章进行排序，匹配度最高的文章会优先显示。

例如：
publishedAtrelevance
publisher
string—

搜索特定发布商的新闻。您可以用逗号分隔多个发布商。

例如：
bbc.comforbes.com,cnn.com,bbc.com
format
stringjson

此参数允许您选择 API 返回的数据格式。您可以选择以下格式： json, csv, or xlsx

例如：
csvxlsx
ai_sentiment
string—

根据人工智能检测到的情感值筛选文章

例如：
positivenegativeneutral
ai_entity_name
string—

按提取的实体名称筛选文章（多个实体名称用逗号分隔）

例如：
AppleMicrosoft,Google
ai_entity_type
string—

按实体类型筛选文章，例如 PERSON、ORG、LOC（多个用逗号分隔）

例如：
ORGPERSON,LOC

回复

API 返回一个 JSON 对象，其中包含与您的搜索条件匹配的新闻文章数组。

姓名
类型
默认值
描述
totalArticles
integer—

与您的搜索查询匹配的文章总数

currentPage
integer—

分页结果中的当前页码

nextPage
integer—

下一页页码（如果在最后一页则为空）

articles
array—

符合搜索条件的文章对象数组

articles[].title
string—

新闻文章的标题

articles[].description
string—

新闻文章的描述或摘要

articles[].category
string—

文章所属类别

articles[].content
string—

新闻文章全文（付费内容）

articles[].country
string—

文章发表所在国家/地区的代码（ISO 3166-1 alpha-2）

articles[].region
string—

文章发表的地理区域

articles[].lang
string—

文章的语言代码（ISO 639-1）

articles[].authors
array—

文章作者姓名数组

articles[].ai_sentiment
string—

AI检测的情感标签（正面、负面或中性）。仅限付费计划。

articles[].ai_sentiment_scores
object—

包含每种情感类别置信度评分的对象。仅限付费用户。

articles[].ai_entities
array—

包含名称和类型字段的已提取命名实体数组。仅限付费计划。

articles[].ai_summary
string—

文章内容的AI生成摘要。仅限付费用户使用。

articles[].url
string—

原文的直接链接

articles[].image
string—

文章的主图或缩略图网址

articles[].publishedAt
string—

文章的发表日期和时间（ISO 8601 格式，UTC）

articles[].source.name
string—

新闻发布者或消息来源的名称

articles[].source.url
string—

新闻来源的主页网址

示例回答

回复

示例请求

查询语法标题终点国家语言