API para obtener países V2

Necesitas una lista limpia de países soportados para consultas de costo de vida, intégrala en tu aplicación y envíala esta semana. Al final de esta guía, podrás obtener todos los países disponibles en una sola llamada y, opcionalmente, consultar datos de costo de vida a nivel de país o ciudad utilizando puntos finales listos para producción en Zyla API Hub.

Qué hace esta API y cuándo usarla

La API de Costo de Vida en Ciudades y Precios Promedio proporciona datos de precios actualizados frecuentemente para artículos cotidianos, servicios públicos, transporte y más, tanto a nivel de país como de ciudad. También expone un punto final para recuperar cada país disponible, de modo que puedas construir selectores validados, autocompletar o precargar opciones antes de consultar puntos finales de precios más profundos.

Los usos típicos incluyen formularios de incorporación que piden la ubicación, características de comparación de precios para herramientas de reubicación, calculadoras de presupuesto para aplicaciones de viaje y verificaciones previas a la llamada de puntos finales detallados (para que nunca consultes un país o ciudad no soportados).

Comenzando en Zyla API Hub

Abre la página de la API en Zyla API Hub y suscríbete para obtener tu clave. Esta API utiliza suscripción + cuota (no pago por llamada). La primera API generalmente ofrece una prueba de 7 días o 50 solicitudes; verifica la lista para confirmar el acceso actual.

• Comienza prueba de 7 días en la API de Costo de Vida en Ciudades y Precios Promedio
• Tu clave API va en el encabezado de Autorización como: Authorization: Bearer YOUR_API_KEY

Puntos finales que usarás

1) Obtener Países V2

Método: GET

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

Descripción: Devuelve todos los países disponibles. No se requieren parámetros de solicitud. Incluye solo el encabezado de Autorización.

Usa esto primero para poblar los selectores de países y validar la entrada antes de llamar a los puntos finales de precios. La respuesta es un arreglo JSON de nombres de países.

2) Costo de Vida por País v2

Método: GET

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

Descripción: Devuelve datos de costo de vida para un país específico. Actualizado frecuentemente.

• Parámetro de consulta requerido: country (string). Valor de ejemplo: united states

Ejemplo oficial de 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"

Ejemplo de respuesta oficial:

{"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…

Qué buscar en esta respuesta:

• Version, Status, Success: Metadatos de respuesta que puedes usar para verificaciones rápidas y monitoreo.
• Country Name: La cadena de país normalizada.
• Campos de precio detallados: Cadenas legibles por humanos que incluyen un símbolo de moneda (por ejemplo, “$”) y unidades donde sea relevante.

3) Costo de Vida por Ciudad v2

Método: GET

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

Descripción: Devuelve datos de precios a nivel de ciudad. Actualizado frecuentemente.

• Parámetros de consulta requeridos:
  • country (string). Valor de ejemplo: United States
  • city (string). Valor de ejemplo: Seattle, WA

Inicio rápido: obtener cada país disponible

Puedes llamar a Obtener Países V2 con solo el encabezado de Autorización. A continuación, un ejemplo en Python que recupera la lista y la filtra para mostrarla en la interfaz de usuario:

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() # esperado: lista de cadenas

# Ejemplo: normalizar y mostrar los primeros 20 para un componente select
normalized = sorted(countries)
for c in normalized[:20]:
print(c)

Ejemplo de respuesta:

["Afganistán","Islas Åland","Albania","Alderney","Argelia","Samoa Americana","Andorra","Angola","Anguila","Antigua y Barbuda","Argentina","Armenia","Aruba","Australia","Austria","Azerbaiyán","Bahamas","Baréin","Bangladesh","Barbados","Bielorrusia","Bélgica","Belice","Benín","Bermudas","Bhután","Bolivia","Bonaire","Bosnia y Herzegovina","Botsuana","Brasil","Islas Vírgenes Británicas","Brunéi","Bulgaria","Burkina Faso","Burundi","Camboya","Camerún","Canadá","Cabo Verde","Islas Caimán","República Centroafricana","Chad","Chile","China","Colombia","Comoras","Islas Cook","Costa Rica","Croacia","Cuba","Curazao","Chipre","República Checa","República Democrática del Congo","Dinamarca","Yibuti","Dominica","República Dominicana","Ecuador","Egipto","El Salvador","Guinea Ecuatorial","Eritrea","Estonia","Esuatini","Etiopía","Islas Malvinas","Islas Feroe","Fiji","Finlandia","Francia","Guayana Francesa","Polinesia Francesa","Territorios Franceses del Sur","Gabón","Gambia","Georgia","Alemania","Ghana","Gibraltar","Grecia","Groenlandia","Granada","Guadalupe","Guam","Guatemala","Guernsey","Guinea","Guinea-Bisáu","Guyana","Haití","Honduras","Hong Kong (China)","Hungría","Islandia","India","Indonesia","Irán…

Notas que ahorran tiempo:

• El formato de respuesta es un arreglo plano de cadenas. No se documentan campos de paginación para este punto final.
• Usa las cadenas de país proporcionadas tal como están al llamar a los puntos finales de país o ciudad. Si tu aplicación requiere capitalización de títulos o localización, mapea internamente pero mantén la cadena que enfrenta a la API intacta.
• Cachea esta lista agresivamente (por ejemplo, 24 horas) y actualízala al iniciar la aplicación. Cambia con mucha menos frecuencia que los precios por país.

Consultar precios por país

Para obtener precios a nivel de país, pasa el parámetro country exactamente como lo requiere el punto final. El ejemplo oficial a continuación obtiene los Estados Unidos. Copia y cambia el parámetro de consulta del país según sea necesario:

Analiza las cadenas de respuesta según sea necesario en tu interfaz de usuario. Los valores incluyen un símbolo de moneda (por ejemplo, “$”) y pueden incluir unidades (por ejemplo, “1 galón”, “1 lb”). Evita asumir campos solo numéricos; extrae números con una expresión regular si necesitas calcular agregados.

Consultar precios por ciudad

Para obtener información a nivel de ciudad, envía tanto los parámetros de país como de ciudad. Mantén la cadena de país consistente con el punto final de países y asegúrate de que tu entrada de ciudad coincida con el formato que mantienes en tu aplicación (por ejemplo, “Seattle, WA”).

Flujo de trabajo recomendado:

1. Llama a Obtener Países V2 para poblar un selector de países.
2. Usa tu propia lista de ciudades por país, o una entrada validada, luego llama al punto final de la ciudad con ambos parámetros.
3. Cachea resultados por ciudad por períodos cortos para evitar repetir búsquedas idénticas.

Detalles prácticos de implementación

• Autenticación: Encabezado de Autorización con Bearer YOUR_API_KEY en cada solicitud.
• Unidades y moneda: Los campos de precio son cadenas e incluyen tanto números como símbolo de unidad/moneda (por ejemplo, “$”). Preséntalos directamente en la interfaz de usuario; analiza solo si es necesario.
• Cacheo: La lista de países puede ser cacheada a largo plazo. Los precios de países y ciudades se actualizan frecuentemente; cachea con un TTL más corto si tu experiencia de usuario lo permite.
• Manejo de errores: Verifica los campos Success y Status (donde estén presentes) para diagnósticos rápidos, y usa códigos de estado HTTP para lógica de reintento/retraso.
• Cuotas y facturación: Modelo de suscripción + cuota. La primera API comúnmente incluye una prueba de 7 días o 50 solicitudes; verifica los detalles en la página de listado.

Casos de uso del mundo real que puedes implementar rápidamente

• Selector de país con autocompletar: Precarga el arreglo de países al inicio, aliméntalo a tu búsqueda en el frontend y pasa las selecciones a los puntos finales de precios.
• Planificador de presupuesto de reubicación: Después de que un usuario elija un país o ciudad, extrae los campos de supermercado, alquiler y transporte para estimar un presupuesto mensual.
• Estimador de costos de viaje: Combina precios de restaurantes, transporte y entretenimiento para proyectar el gasto diario para itinerarios.
• Widget de comparación de precios: Obtén dos ubicaciones y renderiza una comparación lado a lado para artículos clave de la canasta (por ejemplo, pan, leche, gasolina).

Llamar a la API desde un agente de IA a través de MCP

Cada API en Zyla API Hub puede ser llamada desde clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) utilizando el punto final MCP:

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

Proporciona la URL exacta del hub, método y encabezados en la configuración de tu herramienta, y reenvía los parámetros seleccionados por el usuario (por ejemplo, país o ciudad) como cadenas de consulta. Para detalles de configuración, consulta MCP.

Referencia: Resumen de puntos finales

• Obtener Países V2
  • GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/6144/get-countries-v2
  • No hay parámetros. Se requiere autorización.
  • Devuelve: arreglo JSON de nombres de países.
• Costo de Vida por País v2
  • GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3774/cost-of-living-by-country-v2
  • Parámetros: country (string, requerido). Ejemplo: united states
  • Devuelve: Objeto con metadatos y campos de precio detallados.
• Costo de Vida por Ciudad v2
  • GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/3775/cost-of-living-by-city-v2
  • Parámetros: country (string, requerido), city (string, requerido). Ejemplo: country=United States, city=Seattle, WA
  • Devuelve: Objeto con nombre de ciudad y campos de precio detallados.

FAQ

¿Cómo me autentico?
Agrega el encabezado Authorization: Bearer YOUR_API_KEY a cada solicitud.

¿Qué devuelve Obtener Países V2?
Un arreglo JSON de nombres de países soportados por los puntos finales de precios. No se requieren parámetros de consulta.

¿En qué moneda están los precios?
Los precios se devuelven como cadenas que incluyen un símbolo de moneda (por ejemplo, “$”) y a veces unidades. Úsalos directamente en la interfaz de usuario o analiza si necesitas números.

¿Puedo cachear la lista de países?
Sí. Cambia infrecuentemente en relación con los precios; cachearla por un día (o al iniciar) es típico.

¿Hay un plan gratuito?
El acceso es por suscripción + cuota. La primera API generalmente ofrece una prueba de 7 días o 50 solicitudes; verifica la página de la API para opciones de acceso y precios actuales.

¿Listo para integrar? Crea tu cuenta, obtén una clave API y comienza con la lista de países. Luego, conecta las consultas de país y ciudad para potenciar tu interfaz de usuario con precios en vivo. Comienza aquí: Comienza prueba de 7 días en la API de Costo de Vida en Ciudades y Precios Promedio.

Respuesta oficial de la 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…

Respuesta oficial de la 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…