> For the complete documentation index, see [llms.txt](https://docscn.jkidata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docscn.jkidata.com/xin-wen-shu-ju/can-shu-lie-biao.md).

# 🗣参数列表

本页面说明通用新闻接口支持的请求参数。

### 接口路径

```
GET /latest
```

> API 基础地址请参考「新闻数据」首页。

### 参数总览

| 参数             | 类型     | 必填 | 示例                | 说明          |
| -------------- | ------ | -- | ----------------- | ----------- |
| `key`          | string | 是  | `YOUR_API_KEY`    | API 访问密钥    |
| `language`     | string | 否  | `en`              | 新闻语言代码      |
| `country`      | string | 否  | `us`              | 国家或地区代码     |
| `category`     | string | 否  | `business`        | 新闻分类        |
| `q`            | string | 否  | `NASDAQ`          | 搜索关键词       |
| `full_content` | number | 否  | `1`               | 是否请求完整正文    |
| `image`        | number | 否  | `1`               | 是否请求图片或媒体信息 |
| `page`         | string | 否  | `NEXT_PAGE_TOKEN` | 下一页分页标识     |

除 `key` 外，其他参数均为可选参数。

### `key`：API 访问密钥

每次请求都必须传入有效的 API Key。

```
key=YOUR_API_KEY
```

请求示例：

```
GET /latest?key=YOUR_API_KEY
```

{% hint style="warning" %}\
不要在前端代码、客户端安装包或公共代码仓库中暴露真实 API Key。生产环境应由服务端安全保存并调用接口。\
{% endhint %}

### `language`：新闻语言

用于筛选指定语言的新闻。

```
language=en
```

示例：

```
GET /latest?language=en&key=YOUR_API_KEY
```

| 示例值  | 说明  |
| ---- | --- |
| `en` | 英文  |
| `zh` | 中文  |
| `hi` | 印地语 |
| `ja` | 日语  |

> 完整的语言参数请参考「新闻国家和语言参数」页面。

### `country`：国家或地区

用于筛选与指定国家或地区相关的新闻。

```
country=us
```

示例：

```
GET /latest?country=us&key=YOUR_API_KEY
```

| 示例值  | 说明   |
| ---- | ---- |
| `us` | 美国   |
| `cn` | 中国   |
| `hk` | 中国香港 |
| `in` | 印度   |
| `jp` | 日本   |

> 完整的国家参数请参考「新闻国家和语言参数」页面。

### `category`：新闻分类

用于限定新闻内容所属的分类。

```
category=business
```

示例：

```
GET /latest?category=business&key=YOUR_API_KEY
```

#### 支持的分类

| 参数值             | 中文说明  |
| --------------- | ----- |
| `business`      | 商业、财经 |
| `crime`         | 犯罪、法律 |
| `domestic`      | 国内新闻  |
| `education`     | 教育    |
| `entertainment` | 娱乐    |
| `environment`   | 环境、气候 |
| `food`          | 食品、餐饮 |
| `health`        | 健康、医疗 |
| `lifestyle`     | 生活方式  |
| `other`         | 其他    |
| `politics`      | 政治    |
| `science`       | 科学    |
| `sports`        | 体育    |
| `technology`    | 科技    |
| `top`           | 头条、热点 |
| `tourism`       | 旅游    |
| `world`         | 国际新闻  |

{% hint style="info" %}\
获取股票、交易所和上市公司新闻时，推荐使用 `category=business`。\
{% endhint %}

### `q`：搜索关键词

用于搜索标题、摘要或正文中包含指定关键词的新闻。

```
q=NASDAQ
```

示例：

```
GET /latest?category=business&q=NASDAQ&key=YOUR_API_KEY
```

#### 股票新闻推荐关键词

| 关键词        | 适用场景         |
| ---------- | ------------ |
| `stock`    | 综合股票新闻       |
| `share`    | 股份、股市及上市公司新闻 |
| `exchange` | 证券交易所新闻      |
| `NASDAQ`   | NASDAQ 市场新闻  |
| `NYSE`     | NYSE 市场新闻    |
| `NSE`      | 印度 NSE 市场新闻  |
| `BSE`      | 印度 BSE 市场新闻  |
| 公司名称       | 指定公司的相关新闻    |
| 产品代码       | 指定股票或产品的相关新闻 |

查询指定产品：

```
GET /latest?language=en&category=business&q=AAPL&key=YOUR_API_KEY
```

#### URL 编码

当关键词包含中文、空格或特殊字符时，应进行 URL 编码。使用 HTTP 客户端的参数功能可以自动完成编码。

**Python**

```
params = {
    "category": "business",
    "q": "股票",
    "key": JKIDATA_API_KEY,
}

response = requests.get(url, params=params)
```

**JavaScript**

```
const params = new URLSearchParams({
  category: "business",
  q: "股票",
  key: process.env.JKIDATA_API_KEY,
});
```

### `full_content`：完整正文

设置为 `1` 时，请求完整新闻正文。

```
full_content=1
```

请求示例：

```
GET /latest?category=business&q=NASDAQ&full_content=1&key=YOUR_API_KEY
```

| 参数值 | 说明       |
| --- | -------- |
| `1` | 请求完整正文   |
| 不传  | 使用默认内容模式 |

{% hint style="warning" %}\
即使传入 `full_content=1`，部分新闻也可能无法提供完整正文。实际结果取决于新闻来源和内容授权。\
{% endhint %}

### `image`：图片或媒体数据

设置为 `1` 时，请求新闻图片或媒体信息。

```
image=1
```

请求示例：

```
GET /latest?category=business&q=NASDAQ&image=1&key=YOUR_API_KEY
```

| 参数值 | 说明        |
| --- | --------- |
| `1` | 请求图片或媒体信息 |
| 不传  | 使用默认媒体模式  |

并非所有新闻都提供图片或视频。以下字段可能为空：

```
image_url
video_url
```

### `page`：分页标识

当响应中包含 `nextPage` 时，将该值作为下一次请求的 `page` 参数。

```
page=NEXT_PAGE_TOKEN
```

分页请求示例：

```
GET /latest?category=business&q=NASDAQ&page=NEXT_PAGE_TOKEN&key=YOUR_API_KEY
```

{% hint style="warning" %}\
`page` 的值必须来自上一次响应的 `nextPage`。请原样传递，不要自行修改、生成或解析。\
{% endhint %}

翻页时应保留原请求中的其他筛选参数：

```
language=en
category=business
q=NASDAQ
```

如果翻页时修改筛选条件，分页结果可能不连续。

### 常用参数组合

#### 最新英文商业新闻

```
GET /latest?language=en&category=business&key=YOUR_API_KEY
```

#### 美国股票新闻

```
GET /latest?language=en&country=us&category=business&q=stock&key=YOUR_API_KEY
```

#### NASDAQ 新闻

```
GET /latest?language=en&category=business&q=NASDAQ&key=YOUR_API_KEY
```

#### 印度 NSE 新闻

```
GET /latest?language=en&country=in&category=business&q=NSE&key=YOUR_API_KEY
```

#### 中国中文股票新闻

```
GET /latest?language=zh&country=cn&category=business&q=股票&key=YOUR_API_KEY
```

#### 请求正文和图片

```
GET /latest?language=en&category=business&q=NASDAQ&full_content=1&image=1&key=YOUR_API_KEY
```

### 参数使用注意事项

* 参数名称使用小写字母。
* 国家和语言代码建议使用小写值。
* 分类值必须使用支持的英文代码。
* 股票新闻建议组合使用 `category=business` 和 `q`。
* 一次请求建议使用一个明确的核心关键词。
* 不要把分页标识当作普通页码使用。
* 无效参数可能返回业务错误，即使 HTTP 状态码为 `200`。
* 请求结果为空不一定表示接口异常，也可能是筛选条件过于严格。
* 新闻客户端建议每隔 **5–10 分钟**更新一次数据。