🌍 国家地区基础信息 API 接口：全字段查询支持 + Emoji 国旗返回
咕咕数据提供的国家地区基础信息 API，覆盖全球 250+ 国家和地区，支持按国家名称、国家编码、电话区号、货币代码、语言代码、大洲等多条件组合查询，并返回包括 emoji 国旗在内的完整基础信息，广泛应用于全球用户注册、地址表单、出海平台、跨境电商等业务场景。
✅ 产品功能亮点
- 支持全球 250+ 国家和地区；
- 精准返回包括国家名称、编码（alpha-2 / alpha-3）、电话区号、首都、所属大洲等；
- 返回 emoji 格式国旗图标，适合 UI 展示；
- 支持货币代码、语言代码、国家名称等字段筛选；
- HTTPS 接口，毫秒级响应，数据持续维护；
- 免费试用、调用监控透明：
👉 [接口状态与调用监控](www.gugudata.com/status)
📘 API 文档信息
-
请求方式：
`GET` -
返回格式：
`application/json; charset=utf-8` -
接口详情：
[www.gugudata.com/api/details…] -
接口测试地址：
[api.gugudata.com/v2/location…] -
数据预览：
[www.gugudata.com/preview/met…]
🧾 请求参数
| 参数名 | 类型 | 必须 | 示例值 | 说明 |
|--------------|---------|------|---------------|----------------------------------------|
| appkey | string | 是 | YOUR_APPKEY | 咕咕数据注册获取 |
| code | string | 否 | cn | 国家 alpha-2 编码，如 CN、US |
| name | string | 否 | China | 国家名称，支持英文 |
| phone | string | 否 | 86 | 国家电话区号，如中国为 86 |
| continent | string | 否 | Asia | 所属大洲：Asia、Europe 等 |
| currencies | string | 否 | cny,usd | 支持的货币代码，多个使用英文逗号分隔 |
| languages | string | 否 | zh,en | 国家语言代码，多个使用英文逗号分隔 |
🔁 返回字段说明
{
"dataStatus": {
"statusCode": 200,
"statusDescription": "请求成功",
"responseDateTime": "2025-05-29T10:00:00",
"dataTotalCount": 1
},
"data": {
"name": "China",
"alphaTwoCode": "CN",
"alphaThreeCode": "CHN",
"nativeName": "中国",
"phonePrefix": "86",
"continent": "Asia",
"capital": "Beijing",
"currencies": "CNY",
"languages": "zh",
"emoji": "🇨🇳"
}
}
| 字段名 | 类型 | 说明 |
|-------------------------|----------|--------------------------------------|
| dataStatus.statusCode | int | 返回状态码，200 表示成功 |
| dataStatus.statusDescription | string | 接口状态文本说明 |
| dataStatus.responseDateTime | string | 响应时间戳 |
| dataStatus.dataTotalCount | int | 返回的数据条数 |
| data.name | string | 国家名称 |
| data.alphaTwoCode | string | ISO 国家编码（alpha-2） |
| data.alphaThreeCode | string | ISO 国家编码（alpha-3） |
| data.nativeName | string | 本地语言表示的国家名称 |
| data.phonePrefix | string | 国家电话区号 |
| data.continent | string | 所属大洲，如 Asia |
| data.capital | string | 首都名称 |
| data.currencies | string | 国家货币代码（英文逗号分隔） |
| data.languages | string | 国家语言代码（英文逗号分隔） |
| data.emoji | string | 国家 emoji 国旗符号 |
🔍 示例调用
GET https://api.gugudata.com/v2/location/country?appkey=YOUR_APPKEY&name=China
🧠 典型应用场景
- 🌐 跨境平台注册表单：自动联动国家代码和电话区号；
- 🌎 国际电商收件表单：地址结构国际化；
- 📱 App 国际化适配：按用户国家配置 UI 及默认行为；
- 🏳️ 展示国旗列表：通过 emoji 快速渲染国旗图标；
- 💬 多语言配置页面：结合语言字段生成多语言选项；
📚 延伸阅读
- [全球货币汇率查询 API](www.gugudata.com/api/details…)
- [国家 IP 映射 API（根据 IP 识别国家）](www.gugudata.com/api/details…)
- [全球时区信息 API 接口](www.gugudata.com/api/details…)
📬 获取 API Key：
[\点击注册获取 AppKey](www.gugudata.com/register\)
📈 快速接入全球国家基础信息服务，助力你的产品全球化！
