Logo
Section 1 / 3

源端点

了解后端接口及其使用方法。

导入

源端点

了解后端接口及其使用方法。

sources 端点用于后端，提供可用于前端端点查询参数的新闻源。该端点的基础 URI 为 https://newsapi.org/v2/top-headlines/sources。

查询参数

参数类型描述
category字符串用于查找特定类别新闻的新闻源。默认情况下，用户将获得所有类别的新闻源结果。
language字符串用于查找以特定语言发布新闻的新闻源。可用选项参见附录。
country字符串用于查找来自特定国家的新闻源。可用选项参见附录。

使用场景

不使用任何查询参数调用 sources 端点

以下代码展示了如何在不使用任何查询参数的情况下调用 sources 端点，以获取所有可用的新闻源。点击“运行”按钮即可获取全部新闻源。第一个新闻源的 id 将被保存下来，以便后续在 everything 和 top-headlines 端点中使用。

1import requests
2import json
3
4URL = 'https://newsapi.org/v2/top-headlines/sources'
5
6header = {
7    'X-Api-Key': "{{API_KEY}}"
8}
9
10response = requests.request("GET", URL, headers=header).json()
11print(json.dumps(response, indent=4))

响应中包含新闻源的类别、描述、语言、网址、国家、ID 和名称。

  • 第 1 行和第 2 行导入所需的库。
  • 第 4 行指定端点的 URL。
  • 第 6 至 8 行定义请求头。
  • 第 10 行调用 sources 端点。
  • 第 11 行打印调用端点后返回的响应内容。

注意：本课程中将始终使用相同的代码结构。其他端点仅需更改 URL 即可。

使用查询参数调用 sources 端点

上一示例中的结果可以通过上述表格列出的查询参数进行过滤。

以下代码中，我们使用 category 参数获取体育类新闻源。点击“运行”按钮以调用端点并查看响应。

1import requests
2import json
3
4URL = 'https://newsapi.org/v2/top-headlines/sources?category=sports'
5
6header = {
7    'X-Api-Key': "{{API_KEY}}"
8}
9
10response = requests.request("GET", URL, headers=header).json()
11print(json.dumps(response, indent=4))

可以将第 5 行的查询参数 category 替换为其他参数，观察其对结果的筛选效果。

使用多个查询参数调用 sources 端点

该端点也支持同时使用多个查询参数。以下代码展示了如何实现。点击“运行”按钮执行代码。

1import requests
2import json
3
4URL = 'https://newsapi.org/v2/top-headlines/sources?category=sports&language=en'
5
6header = {
7    'X-Api-Key': "{{API_KEY}}"
8}
9
10response = requests.request("GET", URL, headers=header).json()
11print(json.dumps(response, indent=4))

还可以将三个查询参数一起使用，以获得更精确的筛选结果。只需在上述代码中，在其他两个参数之后添加 country 参数即可。

简介

所有内容端点