入门
学习如何发出你的第一个 API 请求并开始获取新闻数据
欢迎使用 AllNewsAPI！本指南将引导您了解如何使用我们的 API 从世界各地获取新闻文章。
1. 获取您的 API 密钥
首先，您需要一个 API 密钥来验证您的请求。注册一个免费帐户即可立即获取您的 API 密钥。
2. 提出您的第一个请求
获取 API 密钥后，即可发出第一个 API 请求。以下是一个简单的示例，用于搜索新闻文章：
3. 理解回应
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 | — | 新闻来源的主页网址 |
提示
免费版功能
免费版包含实时新闻数据访问权限，每天最多 50 次请求，以及 7 天的历史数据。无需信用卡！
后续步骤
您已提交第一个请求，请浏览以下指南了解更多信息：