> 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/cai-wu-shu-ju/gong-si-xin-xi-jie-kou-company-profile.md).

# 🏢 公司信息接口（Company Profile）

获取指定公司的基础资料，包括公司名称、简介、所属行业、所属板块、官方网站、成立时间、负责人和总部地址等信息。

### 接口信息

```
GET /symbol_international_details
```

> 本页面使用相对路径。API 基础地址请参考「财务数据」首页。

### 请求参数

| 参数         | 类型     | 必填 | 示例             | 说明       |
| ---------- | ------ | -- | -------------- | -------- |
| `country`  | string | 是  | `india`        | 国家代码     |
| `exchange` | string | 是  | `NSE`          | 交易所代码    |
| `symbol`   | string | 是  | `360ONE`       | 产品代码     |
| `language` | string | 是  | `en`           | 返回内容的语言  |
| `key`      | string | 是  | `YOUR_API_KEY` | API 访问密钥 |

> 国家、交易所和语言必须正确对应。可用参数请参考「市场 / 国家 / 语言参数说明」页面。

### 请求示例

```
GET /symbol_international_details?country=india&exchange=NSE&symbol=360ONE&language=en&key=YOUR_API_KEY
```

#### cURL

```
curl --request GET \
  "$JKIDATA_BASE_URL/symbol_international_details?country=india&exchange=NSE&symbol=360ONE&language=en&key=$JKIDATA_API_KEY"
```

#### Python

```
import requests

url = f"{JKIDATA_BASE_URL}/symbol_international_details"

params = {
    "country": "india",
    "exchange": "NSE",
    "symbol": "360ONE",
    "language": "en",
    "key": JKIDATA_API_KEY,
}

response = requests.get(url, params=params, timeout=10)
response.raise_for_status()

result = response.json()
print(result)
```

#### JavaScript

```
const params = new URLSearchParams({
  country: "india",
  exchange: "NSE",
  symbol: "360ONE",
  language: "en",
  key: process.env.JKIDATA_API_KEY,
});

const response = await fetch(
  `${process.env.JKIDATA_BASE_URL}/symbol_international_details?${params}`
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const result = await response.json();
console.log(result);
```

### 成功响应示例

```
{
  "status": 0,
  "message": "SUCCESS",
  "data": {
    "country": "india",
    "website": "https://www.example.com",
    "founded": "2008",
    "description": "Company description",
    "language": "en",
    "industry": "Investment Managers",
    "type": "stock",
    "ceo": "Company CEO",
    "indexes": "[{\"name\":\"Index name\"}]",
    "head_office": "Mumbai, India",
    "name": "360 ONE WAM Limited",
    "sector": "Finance"
  },
  "total": 0,
  "page": 0,
  "market": "NSE",
  "symbol": "360ONE",
  "code": "360ONE",
  "interval": null
}
```

> 响应示例仅用于说明数据结构，实际字段值以接口实时返回结果为准。

### `data` 字段说明

| 字段            | 类型            | 说明                        |
| ------------- | ------------- | ------------------------- |
| `country`     | string        | 公司所在国家或所属市场               |
| `name`        | string        | 公司名称                      |
| `description` | string        | 公司简介                      |
| `website`     | string        | 公司官方网站                    |
| `founded`     | string / null | 公司成立时间                    |
| `industry`    | string / null | 所属行业                      |
| `sector`      | string / null | 所属板块                      |
| `type`        | string / null | 产品类型                      |
| `ceo`         | string / null | 公司负责人                     |
| `head_office` | string / null | 公司总部地址                    |
| `language`    | string        | 返回内容的语言                   |
| `indexes`     | string / null | 所属指数信息，当前可能以 JSON 字符串形式返回 |

### `indexes` 解析说明

`indexes` 可能是经过 JSON 编码的字符串，而不是直接嵌套的数组。使用前应先检查数据类型。

#### JavaScript

```
const rawIndexes = result.data?.indexes;

const indexes =
  typeof rawIndexes === "string"
    ? JSON.parse(rawIndexes)
    : rawIndexes ?? [];

console.log(indexes);
```

#### Python

```
import json

raw_indexes = result.get("data", {}).get("indexes")

if isinstance(raw_indexes, str):
    indexes = json.loads(raw_indexes)
else:
    indexes = raw_indexes or []

print(indexes)
```

### 注意事项

* `country`、`exchange` 和 `symbol` 必须属于同一市场。
* `language` 不受支持时，可能返回默认语言、空内容或错误信息。
* 公司资料可能因市场数据源不同而存在字段差异。
* 部分字段可能缺失、为空字符串或返回 `null`，客户端应进行兼容处理。
* 请不要在前端代码或公共代码仓库中暴露真实 API Key。