世界国家信息 API

轻松获取关于世界各国的全面信息 适合开发人员 研究人员 和教育工作者
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

此API暴露了从可信来源提取的数据,提供了一个按照总面积排名的国家结构化数据集。开发者可以检索每个国家的信息,包括其排名、名称、总面积(以平方公里和平方英里为单位)、陆地面积、水域面积以及其占世界陆地面积的百分比。API以JSON格式返回这些数据,具体为一系列JSON对象,其中每个对象代表一个国家,并包含每个数据点的键值对。每个国家的数据都经过精心结构化,确保了一致性和易于解析。API采用简单直观的RESTful架构,设置了一个单一的端点以访问这些数据。开发者可以使用标准的HTTP GET请求来检索整个数据集。实现了错误处理,以提供无效请求的相关信息。数据架构一致且记录良好,使得融入各种应用程序变得轻松。API旨在高效数据检索,并经过优化以处理大量请求。主要端点允许开发者以方便且易于集成的方式程序化访问和利用这一地理相关的信息

API 文档

端点


此端点允许用户获取完整的国家列表


                                                                            
POST https://zylalabs.com/api/10199/world+countries+info+api/19586/get+countries+with+data+available
                                                                            
                                                                        

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {
    "countries": [
        "Russia",
        "Canada",
        "China",
        "United States",
        "Brazil",
        "Australia",
        "India",
        "Argentina",
        "Kazakhstan",
        "Algeria",
        "DR Congo",
        "Saudi Arabia",
        "Mexico",
        "Indonesia",
        "Libya",
        "Iran",
        "Mongolia",
        "Peru",
        "Chad",
        "Niger",
        "Mali",
        "South Africa",
        "Colombia",
        "Ethiopia",
        "Bolivia",
        "Egypt",
        "Tanzania",
        "Nigeria",
        "Venezuela",
        "Pakistan",
        "Mozambique",
        "Namibia",
        "Turkey",
        "Chile",
        "Myanmar",
        "Afghanistan",
        "Gambia",
        "Central African Republic",
        "South Sudan",
        "Ukraine",
        "Botswana",
        "Kenya",
        "Angola",
        "France",
        "Sudan",
        "Vietnam",
        "Guinea",
        "Germany",
        "Philippines",
        "Congo",
        "Finland",
        "Poland",
        "Malaysia",
        "Cote d'Ivoire",
        "Spain",
        "Sweden",
        "Uzbekistan",
        "Madagascar",
        "New Zealand",
        "Papua New Guinea",
        "Western Sahara",
        "Gabon",
        "United Kingdom",
        "Oman",
        "Ecuador",
        "Burkina Faso",
        "Laos",
        "Bulgaria",
        "Kyrgyzstan",
        "Senegal",
        "Cambodia",
        "Uruguay",
        "Honduras",
        "Benin",
        "Bangladesh",
        "Nepal",
        "Tajikistan",
        "Nicaragua",
        "North Korea",
        "Malawi",
        "Eritrea",
        "Armenia",
        "Liberia",
        "Lithuania",
        "Cuba",
        "Guatemala",
        "South Korea",
        "Hungary",
        "Portugal",
        "Serbia",
        "Austria",
        "Dominican Republic",
        "United Arab Emirates",
        "French Guiana",
        "Cambodia",
        "Panama",
        "Serbia",
        "Thailand",
        "Georgia",
        "Sri Lanka",
        "Latvia",
        "Togo",
        "Croatia",
        "Bosnia and Herzegovina",
        "Costa Rica",
        "Dominica",
        "Equatorial Guinea",
        "Denmark",
        "Solomon Islands",
        "Netherlands Antilles",
        "Bahrain",
        "Taiwan",
        "Tonga",
        "Guinea-Bissau",
        "Belize",
        "Mauritius",
        "Comoros",
        "Grenada",
        "Mozambique",
        "Albania",
        "Equatorial Guinea",
        "Burundi",
        "Haiti",
        "Republic of North Macedonia",
        "Djibouti",
        "El Salvador",
        "Jamaica",
        "Samoa",
        "Montenegro",
        "Palestine",
        "Palau",
        "Qatar",
        "Gambia",
        "Lebanon",
        "Cyprus",
        "Puerto Rico",
        "State of Palestine",
        "Brunei",
        "Trinidad and Tobago",
        "Swaziland",
        "Czech Republic",
        "Serbia",
        "Luxembourg",
        "Mauritius",
        "Maldives",
        "Comoros",
        "Guyana",
        "Sao Tome and Principe",
        "Macao",
        "Bahrain",
        "Djibouti",
        "Slovenia",
        "Tonga",
        "Singapore",
        "Micronesia",
        "Saint Lucia",
        "East Timor",
        "Andorra",
        "Armenia",
        "Northern Mariana Islands",
        "Palau",
        "Seychelles",
        "Curacao",
        "Antigua and Barbuda",
        "Barbados",
        "Saint Vincent and the Grenadines",
        "Guyana",
        "Mayotte",
        "United States",
        "Virgin Islands",
        "Greenland",
        "Northern Mariana Islands",
        "Maldives",
        "Cayman Islands",
        "Guam",
        "Saint Kitts and Nevis",
        "Mendoza",
        "Saint Pierre and Miquelon",
        "Marshall Islands",
        "Brunei",
        "Liechtenstein",
        "British Virgin Islands",
        "Republic of Palau",
        "Montserrat",
        "Anguilla",
        "Bermuda",
        "Gorno-Badakhshan",
        "China, Macao SAR",
        "San Marino",
        "Tuvalu",
        "Maldives",
        "Saint Barthelemy",
        "Tel Aviv",
        "Micronesia",
        "Holy See"
    ]
}
                                                                                                                                                                                                                    
                                                                                                    

获取有数据的国家 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/10199/world+countries+info+api/19586/get+countries+with+data+available' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{}'


该端点提供特定国家的总面积(平方公里)要使用它,您必须将一个国家作为参数指明您可以从第一个端点获取它们


                                                                            
POST https://zylalabs.com/api/10199/world+countries+info+api/19591/get+total+area+by+country
                                                                            
                                                                        

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        [
    {
        "country": "Argentina",
        "total_area_sq_km": 2736690
    }
]
                                                                                                                                                                                                                    
                                                                                                    

按国家获取总面积 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/10199/world+countries+info+api/19591/get+total+area+by+country' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{"country":"Required"}'


该端点提供特定国家的陆地面积(平方公里)和世界陆地质量百分比。要使用它,您必须将一个国家作为参数指定。您可以从第一个端点获取它们


                                                                            
POST https://zylalabs.com/api/10199/world+countries+info+api/19596/get+land+area+and+world+share+by+country
                                                                            
                                                                        

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        [
    {
        "country": "Russia",
        "land_area": 16376870,
        "world_landmass_percentage": 11
    }
]
                                                                                                                                                                                                                    
                                                                                                    

获取各国的土地面积和世界份额 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/10199/world+countries+info+api/19596/get+land+area+and+world+share+by+country' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{"country":"Required"}'


该端点为用户提供特定国家的排名区域。要使用它,您必须将一个国家作为参数指示。您可以从第一个端点获取它们


                                                                            
POST https://zylalabs.com/api/10199/world+countries+info+api/19601/get+size+ranking+by+country
                                                                            
                                                                        

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        [
    {
        "country": "Spain",
        "rank": 52
    }
]
                                                                                                                                                                                                                    
                                                                                                    

按国家获取规模排名 - 代码片段


curl --location --request POST 'https://zylalabs.com/api/10199/world+countries+info+api/19601/get+size+ranking+by+country' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{"country":"Required"}'


API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 世界国家信息 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

世界国家信息 API FAQs

该API提供了一个全面的数据集,列出了按总面积排名的国家,包括排名、名称、总面积(以平方公里和平方英里计算)、陆地面积、水域面积以及每个国家占全球陆地总面积的百分比

API以结构化的JSON格式返回数据,具体为一组JSON对象的列表,其中每个对象代表一个国家,包含每个数据点的键值对

开发人员可以使用此API创建需要地理信息的应用程序,例如教育工具、旅行应用、数据可视化项目或任何需要显示或分析国家大小和排名的应用程序

API的输出包括排名国家名称总面积(以平方公里和平方英里计)陆地面积水域面积以及每个国家占世界陆地总面积的百分比

开发者可以通过向主要端点发出标准的HTTP GET请求来轻松集成API,以检索整个数据集,从而实现地理数据在各种应用中的无缝整合

每个端点返回关于国家的特定数据 “获取可用数据的国家”端点列出了所有国家 “按国家获取总面积”端点提供指定国家的总面积(以平方千米为单位) “按国家获取陆地面积和世界份额”端点返回一个国家的陆地面积和全球陆地总量的百分比 “按国家获取面积排名”端点根据国家的面积提供排名

关键字段因终端不同而异。对于“获取有数据的国家”,它返回国家名称列表。“按国家获取总面积”终端包括“国家”和“总面积平方千米”。“按国家获取陆地面积和世界份额”终端提供“国家”、“陆地面积”和“世界陆地百分比”。“按国家获取大小排名”终端返回“国家”和“排名”

响应数据以JSON格式组织 每个端点返回一个国家列表或包含每个国家特定数据点的对象数组 例如 总面积端点返回一个包含国家名称及其总面积的对象数组 确保结构一致便于解析

每个端点都需要特定的参数。对于"按国家获取总面积""按国家获取陆地面积和全球份额"以及"按国家获取大小排名"端点,用户必须将国家名称指定为参数。这允许用户从数据集中检索特定国家的目标信息

用户可以通过解析 JSON 响应来提取相关信息,以利用返回的数据。例如,开发人员可以在他们的应用程序中显示一个国家的总面积或排名。结构化格式方便集成到数据可视化工具、教育平台或地理分析应用中

典型的用例包括教授地理的教育应用程序 提供国家统计信息的旅行应用程序 以及可视化土地面积比较的数据分析工具 研究人员还可能使用这些数据进行土地分配和环境影响评估的研究

该API从可靠的数据集中获取数据,以确保高准确性。定期进行更新和质量检查,以验证所提供信息的一致性和可靠性,使用户能够信任其应用程序中的数据

每个端点提供不同的信息:“获取可用数据的国家”端点列出所有国家;“按国家获取总面积”端点提供总面积(以平方公里计算);“按国家获取陆地面积和世界占比”端点提供陆地面积和世界百分比;“按国家获取面积排名”端点根据面积提供排名

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。

价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]


此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。

定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。

有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]

价格由月度或年度订阅决定,具体取决于所选计划。

API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。

Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。

要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。

要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。

要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。

"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。


相关 API