获取国家的 API V2

您需要一个干净的支持国家列表用于生活成本查询，将其接入您的应用，并在本周发布。在本指南结束时，您将能够一次性获取所有可用国家，并可选择使用 Zyla API Hub 上的生产就绪端点查询国家或城市级别的生活成本数据。

此 API 的功能及使用时机

城市生活成本和平均价格 API 提供了日常物品、公用事业、交通等的定期更新定价数据，涵盖国家和城市的细节。它还提供一个端点来检索每个可用国家，以便您可以构建经过验证的选择器、自动完成或在查询更深层的定价端点之前预加载选项。

典型用例包括询问位置的入职表单、用于搬迁工具的价格比较功能、旅行应用的预算计算器，以及在调用详细端点之前的预飞检查（以确保您不会查询不支持的国家或城市）。

在 Zyla API Hub 上开始

打开 Zyla API Hub 上的 API 页面并订阅以获取您的密钥。此 API 使用订阅 + 配额（而非按调用计费）。第一个 API 通常提供 7 天的试用或 50 次请求——请检查列表以确认当前访问权限。

开始 7 天试用城市生活成本和平均价格 API
您的 API 密钥应放在 Authorization 头中，如：Authorization: Bearer YOUR_API_KEY

您将使用的端点

1) 获取国家 V2

方法：GET

URL： https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/6144/get-countries-v2

描述：返回所有可用国家。无需请求参数。仅需包含 Authorization 头。

首先使用此方法填充国家选择器并验证输入，然后再调用定价端点。响应是一个国家名称的 JSON 数组。

2) 按国家的生活成本 v2

方法：GET

URL： https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3774/cost-of-living-by-country-v2

描述：返回特定国家的生活成本数据。定期更新。

必需的查询参数：country（字符串）。示例值：united states

官方 cURL 示例：

curl -s -X GET "https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3774/cost-of-living-by-country-v2?country=united+states" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例响应：

{"Version":1,"Status":200,"Success":true,"Country Name":"United States","Meal, Inexpensive Restaurant":"20.00 $","Meal for 2 People, Mid-range Restaurant, Three-course":"78.00 $","McMeal at McDonalds (or Equivalent Combo Meal)":"12.00 $","Domestic Beer (1 pint draught)":"6.00 $","Imported Beer (12 oz small bottle)":"3.61 $","Cappuccino (regular)":"5.30 $","Coke/Pepsi (12 oz small bottle)":"2.59 $","Water (12 oz small bottle)":"2.10 $","Milk (regular), (1 gallon)":"4.03 $","Loaf of Fresh White Bread (1 lb)":"3.32 $","Rice (white), (1 lb)":"2.08 $","Eggs (regular) (12)":"4.41 $","Local Cheese (1 lb)":"5.91 $","Chicken Fillets (1 lb)":"5.56 $","Beef Round (1 lb) (or Equivalent Back Leg Red Meat)":"7.48 $","Apples (1 lb)":"2.38 $","Banana (1 lb)":"0.76 $","Oranges (1 lb)":"2.03 $","Tomato (1 lb)":"2.22 $","Potato (1 lb)":"1.32 $","Onion (1 lb)":"1.39 $","Lettuce (1 head)":"2.21 $","Water (1.5 liter bottle)":"2.25 $","Bottle of Wine (Mid-Range)":"15.00 $","Domestic Beer (0.5 liter bottle)":"2.01 $","Cigarettes 20 Pack (Marlboro)":"10.00 $","One-way Ticket (Local Transport)":"2.50 $","Monthly Pass (Regular Price)":"65.00 $","Taxi Start (Normal Tariff)":"3.55 $","Taxi 1 mile (Normal Tariff)":"2.80 $","Taxi 1hour Waiting (Normal Tariff)":"30.00 $","Gasoline (1 gallon)":"3.39 $","Volkswagen Golf 1.4 90 KW Trendline (Or Equivalent New Car)":"34,501.73 $","Toyota Corolla Sedan 1.6l 97kW Comfort (Or Equivalent New Car)":"26,061.57 $","Basic (Electricity, Heating, Cooling, Water, Garbage) for 915 sq ft Apartment":"210.13 $","Mobile Phone Monthly Plan with Calls and 10GB+ Data":"60.54 $","Internet (60 Mbps or More, Unlimited Data, Cable/ADSL)":"72.33 $","Fitness Club, Monthly Fee for 1 Adult":"45.73 $","Tennis Court Rent (1 Hour on Weekend)":"21.89 $","Cinema, International Release, 1 Seat":"15.00 $","Preschool (or Kindergarten), Full Day, Private, Monthly for 1 Child":"1,366.88 $","International Primary School, Yearly for 1 Child":"23,152.86 $","1 Pair of Jeans (Levis 501 Or Similar)":"52.37 $","1 Summer Dress in a Chain Store (Zara, H&M, ...)":"42.80 $","1 Pair of Nike Running Shoes (Mid-Range)":"90.64 $","1 Pair of Men Leather Business Shoes":"113.57 $","Apartment (1 bedroom) in City Centre":"1,729.16 $","Apartment (1 bedroom) Outside…

在此响应中需要注意的内容：

Version、Status、Success：您可以用于快速检查和监控的响应元数据。
Country Name：标准化的国家字符串。
逐项价格字段：包含货币符号（例如，“$”）和相关单位的人类可读字符串。

3) 按城市的生活成本 v2

方法：GET

URL： https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3775/cost-of-living-by-city-v2

描述：返回城市级别的定价数据。定期更新。

必需的查询参数：
- country（字符串）。示例值：United States
- city（字符串）。示例值：Seattle, WA

快速入门：获取每个可用国家

您可以仅使用 Authorization 头调用获取国家 V2。以下是一个 Python 示例，它检索列表并对其进行过滤以供 UI 显示：

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/6144/get-countries-v2"

headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, headers=headers, timeout=20)
resp.raise_for_status()
countries = resp.json() # expected: list of strings

# 示例：规范化并显示前 20 个供选择组件使用
normalized = sorted(countries)
for c in normalized[:20]:
print(c)

示例响应：

["Afghanistan","Aland Islands","Albania","Alderney","Algeria","American Samoa","Andorra","Angola","Anguilla","Antigua And Barbuda","Argentina","Armenia","Aruba","Australia","Austria","Azerbaijan","Bahamas","Bahrain","Bangladesh","Barbados","Belarus","Belgium","Belize","Benin","Bermuda","Bhutan","Bolivia","Bonaire","Bosnia And Herzegovina","Botswana","Brazil","British Virgin Islands","Brunei","Bulgaria","Burkina Faso","Burundi","Cambodia","Cameroon","Canada","Cape Verde","Cayman Islands","Central African Republic","Chad","Chile","China","Colombia","Comoros","Cook Islands","Costa Rica","Croatia","Cuba","Curacao","Cyprus","Czech Republic","Democratic Republic of the Congo","Denmark","Djibouti","Dominica","Dominican Republic","Ecuador","Egypt","El Salvador","Equatorial Guinea","Eritrea","Estonia","Eswatini","Ethiopia","Falkland Islands","Faroe Islands","Fiji","Finland","France","French Guiana","French Polynesia","French Southern Territories","Gabon","Gambia","Georgia","Germany","Ghana","Gibraltar","Greece","Greenland","Grenada","Guadeloupe","Guam","Guatemala","Guernsey","Guinea","Guinea-Bissau","Guyana","Haiti","Honduras","Hong Kong (China)","Hungary","Iceland","India","Indonesia","Ira…

节省时间的注意事项：

响应格式是一个平面字符串数组。此端点未记录分页字段。
在调用国家或城市端点时，直接使用提供的国家字符串。如果您的应用需要标题大小写或本地化，请在内部进行映射，但保持 API 面向的字符串不变。
积极缓存此列表（例如，24 小时），并在应用启动时刷新。它的变化频率远低于每个国家的价格。

按国家查询价格

要提取国家范围内的价格，请准确传递国家参数，如端点所需。以下官方示例提取美国。复制并根据需要更换国家查询参数：

根据需要在您的 UI 中解析响应字符串。值包括货币符号（例如，“$”）并可能包括单位（例如，“1 加仑”、“1 磅”）。避免假设仅为数字的字段——如果您必须计算聚合，请使用正则表达式提取数字。

按城市查询价格

对于城市级别的见解，发送国家和城市参数。保持国家字符串与国家端点一致，并确保您的城市输入与您在应用中维护的格式匹配（例如，“Seattle, WA”）。

推荐工作流程：

调用获取国家 V2 以填充国家选择。
使用您自己的每个国家的城市列表，或经过验证的输入，然后使用两个参数调用城市端点。
每个城市缓存结果以短期避免重复相同的查找。

实际实施细节

身份验证：每个请求的 Authorization 头中包含 Bearer YOUR_API_KEY。
单位和货币：价格字段为字符串，包含数字和单位/货币符号（例如，“$”）。直接在 UI 中呈现这些；仅在需要时解析。
缓存：国家列表可以长时间缓存。国家和城市价格更新频繁；如果您的用户体验允许，请使用较短的 TTL 进行缓存。
错误处理：检查 Success 和 Status 字段（如果存在）以进行快速诊断，并使用 HTTP 状态代码进行重试/退避逻辑。
配额和计费：订阅 + 配额模型。第一个 API 通常包括 7 天的试用或 50 次请求——请在列表页面上验证详细信息。

您可以快速发布的实际用例

自动完成国家选择器：在启动时预加载国家数组，将其提供给前端搜索，并将选择传递给价格端点。
搬迁预算规划器：在用户选择国家或城市后，提取杂货、租金和交通字段以估算每月预算。
旅行成本估算器：结合餐厅、交通和娱乐价格，预测行程的每日支出。
价格比较小部件：提取两个地点并渲染关键购物篮项目（例如，面包、牛奶、汽油）的并排差异。

通过 MCP 从 AI 代理调用 API

Zyla API Hub 上的每个 API 都可以通过与 MCP 兼容的客户端（例如，Claude Code、Cursor、Windsurf）使用 MCP 端点调用：

https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

在您的工具配置中提供确切的 Hub URL、方法和头，并将用户选择的参数（例如，国家或城市）作为查询字符串转发。有关设置详细信息，请参见 MCP。

参考：端点摘要

获取国家 V2
- GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/6144/get-countries-v2
- 无参数。需要授权。
- 返回：国家名称的 JSON 数组。
按国家的生活成本 v2
- GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3774/cost-of-living-by-country-v2
- 参数：country（字符串，必需）。示例：united states
- 返回：包含元数据和逐项价格字段的对象。
按城市的生活成本 v2
- GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3775/cost-of-living-by-city-v2
- 参数：country（字符串，必需），city（字符串，必需）。示例：country=United States, city=Seattle, WA
- 返回：包含城市名称和逐项价格字段的对象。

常见问题

我该如何进行身份验证？
在每个请求中添加头 Authorization: Bearer YOUR_API_KEY。

获取国家 V2 返回什么？
一个 JSON 数组，包含定价端点支持的国家名称。无需查询参数。

价格使用什么货币？
价格作为字符串返回，包括货币符号（例如，“$”）和有时的单位。直接在 UI 中使用它们，或者在需要数字时解析。

我可以缓存国家列表吗？
可以。与定价相比，它的变化频率较低；通常将其缓存一天（或在启动时）是典型的做法。

是否有免费计划？
访问是订阅 + 配额。第一个 API 通常提供 7 天的试用或 50 次请求——请检查 API 页面以获取当前访问选项和定价。

准备好集成了吗？创建您的帐户，获取 API 密钥，并从国家列表开始。然后将国家和城市查询接入，以便为您的 UI 提供实时价格。从这里开始：开始 7 天试用城市生活成本和平均价格 API。

官方 API 响应

{"Version":1,"Status":200,"Success":true,"Country Name":"United States","Meal, Inexpensive Restaurant":"20.00$","Meal for 2 People, Mid-range Restaurant, Three-course":"78.00$","McMeal at McDonalds (or Equivalent Combo Meal)":"12.00$","Domestic Beer (1 pint draught)":"6.00$","Imported Beer (12 oz small bottle)":"3.61$","Cappuccino (regular)":"5.30$","Coke/Pepsi (12 oz small bottle)":"2.59$","Water (12 oz small bottle)":"2.10$","Milk (regular), (1 gallon)":"4.03$","Loaf of Fresh White Bread (1 lb)":"3.32$","Rice (white), (1 lb)":"2.08$","Eggs (regular) (12)":"4.41$","Local Cheese (1 lb)":"5.91$","Chicken Fillets (1 lb)":"5.56$","Beef Round (1 lb) (or Equivalent Back Leg Red Meat)":"7.48$","Apples (1 lb)":"2.38$","Banana (1 lb)":"0.76$","Oranges (1 lb)":"2.03$","Tomato (1 lb)":"2.22$","Potato (1 lb)":"1.32$","Onion (1 lb)":"1.39$","Lettuce (1 head)":"2.21$","Water (1.5 liter bottle)":"2.25$","Bottle of Wine (Mid-Range)":"15.00$","Domestic Beer (0.5 liter bottle)":"2.01$","Cigarettes 20 Pack (Marlboro)":"10.00$","One-way Ticket (Local Transport)":"2.50$","Monthly Pass (Regular Price)":"65.00$","Taxi Start (Normal Tariff)":"3.55$","Taxi 1 mile (Normal Tariff)":"2.80$","Taxi 1hour Waiting (Normal Tariff)":"30.00$","Gasoline (1 gallon)":"3.39$","Volkswagen Golf 1.4 90 KW Trendline (Or Equivalent New Car)":"34,501.73$","Toyota Corolla Sedan 1.6l 97kW Comfort (Or Equivalent New Car)":"26,061.57$","Basic (Electricity, Heating, Cooling, Water, Garbage) for 915 sq ft Apartment":"210.13$","Mobile Phone Monthly Plan with Calls and 10GB+ Data":"60.54$","Internet (60 Mbps or More, Unlimited Data, Cable/ADSL)":"72.33$","Fitness Club, Monthly Fee for 1 Adult":"45.73$","Tennis Court Rent (1 Hour on Weekend)":"21.89$","Cinema, International Release, 1 Seat":"15.00$","Preschool (or Kindergarten), Full Day, Private, Monthly for 1 Child":"1,366.88$","International Primary School, Yearly for 1 Child":"23,152.86$","1 Pair of Jeans (Levis 501 Or Similar)":"52.37$","1 Summer Dress in a Chain Store (Zara, H&M, ...)":"42.80$","1 Pair of Nike Running Shoes (Mid-Range)":"90.64$","1 Pair of Men Leather Business Shoes":"113.57$","Apartment (1 bedroom) in City Centre":"1,729.16$","Apartment (1 bedroom) Outside…

官方 API 响应

{"Version":1,"Status":200,"Success":true,"Country Name":"United States","Meal, Inexpensive Restaurant":"20.00$","Meal for 2 People, Mid-range Restaurant, Three-course":"78.00$","McMeal at McDonalds (or Equivalent Combo Meal)":"12.00$","Domestic Beer (1 pint draught)":"6.00$","Imported Beer (12 oz small bottle)":"3.61$","Cappuccino (regular)":"5.30$","Coke/Pepsi (12 oz small bottle)":"2.59$","Water (12 oz small bottle)":"2.10$","Milk (regular), (1 gallon)":"4.03$","Loaf of Fresh White Bread (1 lb)":"3.32$","Rice (white), (1 lb)":"2.08$","Eggs (regular) (12)":"4.41$","Local Cheese (1 lb)":"5.91$","Chicken Fillets (1 lb)":"5.56$","Beef Round (1 lb) (or Equivalent Back Leg Red Meat)":"7.48$","Apples (1 lb)":"2.38$","Banana (1 lb)":"0.76$","Oranges (1 lb)":"2.03$","Tomato (1 lb)":"2.22$","Potato (1 lb)":"1.32$","Onion (1 lb)":"1.39$","Lettuce (1 head)":"2.21$","Water (1.5 liter bottle)":"2.25$","Bottle of Wine (Mid-Range)":"15.00$","Domestic Beer (0.5 liter bottle)":"2.01$","Cigarettes 20 Pack (Marlboro)":"10.00$","One-way Ticket (Local Transport)":"2.50$","Monthly Pass (Regular Price)":"65.00$","Taxi Start (Normal Tariff)":"3.55$","Taxi 1 mile (Normal Tariff)":"2.80$","Taxi 1hour Waiting (Normal Tariff)":"30.00$","Gasoline (1 gallon)":"3.39$","Volkswagen Golf 1.4 90 KW Trendline (Or Equivalent New Car)":"34,501.73$","Toyota Corolla Sedan 1.6l 97kW Comfort (Or Equivalent New Car)":"26,061.57$","Basic (Electricity, Heating, Cooling, Water, Garbage) for 915 sq ft Apartment":"210.13$","Mobile Phone Monthly Plan with Calls and 10GB+ Data":"60.54$","Internet (60 Mbps or More, Unlimited Data, Cable/ADSL)":"72.33$","Fitness Club, Monthly Fee for 1 Adult":"45.73$","Tennis Court Rent (1 Hour on Weekend)":"21.89$","Cinema, International Release, 1 Seat":"15.00$","Preschool (or Kindergarten), Full Day, Private, Monthly for 1 Child":"1,366.88$","International Primary School, Yearly for 1 Child":"23,152.86$","1 Pair of Jeans (Levis 501 Or Similar)":"52.37$","1 Summer Dress in a Chain Store (Zara, H&M, ...)":"42.80$","1 Pair of Nike Running Shoes (Mid-Range)":"90.64$","1 Pair of Men Leather Business Shoes":"113.57$","Apartment (1 bedroom) in City Centre":"1,729.16$","Apartment (1 bedroom) Outside…