> 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/xin-wen-guo-jia-he-yu-yin-can-shu.md).

# 🌐新闻国家和语音参数

新闻接口支持通过 `country` 和 `language` 参数筛选指定国家、地区及语言的新闻。

> 新闻接口使用两位代码，例如美国使用 `us`、印度使用 `in`。这与财务接口中的 `america`、`india` 等参数不同，请勿混用。

### 国家和地区参数

#### 亚洲

| 国家或地区 | 参数值  |
| ----- | ---- |
| 中国    | `cn` |
| 中国香港  | `hk` |
| 中国台湾  | `tw` |
| 印度    | `in` |
| 日本    | `jp` |
| 韩国    | `kr` |
| 新加坡   | `sg` |
| 泰国    | `th` |
| 马来西亚  | `my` |
| 印度尼西亚 | `id` |
| 越南    | `vn` |
| 菲律宾   | `ph` |
| 巴基斯坦  | `pk` |
| 孟加拉国  | `bd` |
| 斯里兰卡  | `lk` |
| 沙特阿拉伯 | `sa` |
| 阿联酋   | `ae` |
| 以色列   | `il` |
| 土耳其   | `tr` |

#### 美洲

| 国家或地区 | 参数值  |
| ----- | ---- |
| 美国    | `us` |
| 加拿大   | `ca` |
| 墨西哥   | `mx` |
| 巴西    | `br` |
| 阿根廷   | `ar` |
| 智利    | `cl` |
| 哥伦比亚  | `co` |
| 秘鲁    | `pe` |
| 委内瑞拉  | `ve` |

#### 欧洲

| 国家或地区 | 参数值  |
| ----- | ---- |
| 英国    | `gb` |
| 德国    | `de` |
| 法国    | `fr` |
| 意大利   | `it` |
| 西班牙   | `es` |
| 葡萄牙   | `pt` |
| 荷兰    | `nl` |
| 比利时   | `be` |
| 瑞士    | `ch` |
| 奥地利   | `at` |
| 爱尔兰   | `ie` |
| 波兰    | `pl` |
| 瑞典    | `se` |
| 挪威    | `no` |
| 丹麦    | `dk` |
| 芬兰    | `fi` |
| 希腊    | `gr` |
| 乌克兰   | `ua` |
| 俄罗斯   | `ru` |

#### 大洋洲与非洲

| 国家或地区 | 参数值  |
| ----- | ---- |
| 澳大利亚  | `au` |
| 新西兰   | `nz` |
| 南非    | `za` |
| 尼日利亚  | `ng` |
| 埃及    | `eg` |
| 肯尼亚   | `ke` |
| 摩洛哥   | `ma` |
| 加纳    | `gh` |
| 坦桑尼亚  | `tz` |

{% hint style="info" %}\
不同国家的新闻数量和更新频率可能存在差异。返回空数组不一定表示接口异常，也可能表示当前筛选条件下暂时没有相关新闻。\
{% endhint %}

### 语言参数

| 语言     | 参数值  |
| ------ | ---- |
| 英语     | `en` |
| 中文     | `zh` |
| 印地语    | `hi` |
| 日语     | `ja` |
| 韩语     | `ko` |
| 泰语     | `th` |
| 越南语    | `vi` |
| 印度尼西亚语 | `id` |
| 马来语    | `ms` |
| 阿拉伯语   | `ar` |
| 土耳其语   | `tr` |
| 德语     | `de` |
| 法语     | `fr` |
| 意大利语   | `it` |
| 西班牙语   | `es` |
| 葡萄牙语   | `pt` |
| 荷兰语    | `nl` |
| 俄语     | `ru` |
| 波兰语    | `pl` |
| 瑞典语    | `sv` |
| 挪威语    | `no` |
| 丹麦语    | `da` |
| 芬兰语    | `fi` |
| 希腊语    | `el` |
| 希伯来语   | `he` |
| 乌克兰语   | `uk` |

### 参数使用方式

#### 指定国家

```
country=us
```

#### 指定语言

```
language=en
```

#### 同时指定国家和语言

```
country=us&language=en
```

### 请求示例

#### 美国英文商业新闻

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

#### 印度英文股票新闻

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

#### 印度 NSE 新闻

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

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

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

#### 日本日文商业新闻

```
GET /latest?country=jp&language=ja&category=business&key=YOUR_API_KEY
```

#### 中国香港英文股票新闻

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

### 国家与语言组合说明

`country` 用于筛选新闻来源国家或地区，`language` 用于筛选新闻内容语言。两个参数可以单独使用，也可以组合使用。

获取来自印度的英文新闻：

```
country=in&language=en
```

获取来自中国的中文新闻：

```
country=cn&language=zh
```

获取来自中国香港的英文新闻：

```
country=hk&language=en
```

部分国家或地区可能同时提供多种语言的新闻，应根据目标用户选择适合的参数组合。

### 股票市场推荐组合

| 市场     | 推荐参数                                                |
| ------ | --------------------------------------------------- |
| 美国股票市场 | `country=us&language=en&category=business&q=stock`  |
| NASDAQ | `country=us&language=en&category=business&q=NASDAQ` |
| NYSE   | `country=us&language=en&category=business&q=NYSE`   |
| 印度股票市场 | `country=in&language=en&category=business&q=stock`  |
| 印度 NSE | `country=in&language=en&category=business&q=NSE`    |
| 印度 BSE | `country=in&language=en&category=business&q=BSE`    |
| 中国股票市场 | `country=cn&language=zh&category=business&q=股票`     |
| 日本股票市场 | `country=jp&language=ja&category=business&q=株式`     |

### 请求参数与响应字段

请求中的国家和语言使用代码：

```
country=us
language=en
```

响应中的 `country` 和 `language` 通常返回完整名称：

```
{
  "language": "english",
  "country": [
    "united states of america"
  ]
}
```

中国中文新闻可能返回：

```
{
  "language": "chinese",
  "country": [
    "china"
  ]
}
```

因此，请求参数值与响应字段值不一定相同。

### 使用注意事项

* 国家和语言代码使用小写字母。
* 新闻接口与财务接口使用不同的国家参数格式。
* 新闻接口使用 `us`、`in`、`jp` 等两位代码。
* 财务接口可能使用 `america`、`india`、`japan` 等完整参数。
* 不要直接使用响应中的完整国家名称作为请求参数。
* `country` 和 `language` 可以单独使用，也可以组合使用。
* 筛选条件过多时，可能返回较少数据或空数组。
* 一条新闻可能与多个国家相关，因此响应中的 `country` 可能是数组。
* 新闻来源国家不一定等于新闻事件发生国家。
* 参数受支持不代表当前一定存在对应新闻内容。