API para obter países V2

Você precisa de uma lista limpa de países suportados para consultas de custo de vida, integrá-la ao seu aplicativo e lançar esta semana. Ao final deste guia, você obterá todos os países disponíveis em uma única chamada e, opcionalmente, consultará dados de custo de vida em nível de país ou cidade usando endpoints prontos para produção no Zyla API Hub.

O que esta API faz e quando usá-la

A API de Custo de Vida das Cidades e Preços Médios fornece dados de preços frequentemente atualizados para itens do dia a dia, utilidades, transporte e mais, tanto em granularidade de país quanto de cidade. Ela também expõe um endpoint para recuperar todos os países disponíveis, para que você possa construir seletores validados, autocompletar ou pré-carregar opções antes de consultar endpoints de preços mais profundos.

Usos típicos incluem formulários de integração que solicitam localização, recursos de comparação de preços para ferramentas de realocação, calculadoras de orçamento para aplicativos de viagem e verificações prévias antes de chamar endpoints detalhados (para que você nunca consulte um país ou cidade não suportados).

Começando no Zyla API Hub

Abra a página da API no Zyla API Hub e inscreva-se para obter sua chave. Esta API utiliza assinatura + cota (não paga por chamada). A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações—verifique a listagem para confirmar o acesso atual.

• Iniciar teste de 7 dias na API de Custo de Vida das Cidades e Preços Médios
• Sua chave de API deve ser colocada no cabeçalho de Autorização como: Authorization: Bearer YOUR_API_KEY

Endpoints que você usará

1) Obter Países V2

Método: GET

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

Descrição: Retorna todos os países disponíveis. Nenhum parâmetro de solicitação é necessário. Inclua apenas o cabeçalho de Autorização.

Use isso primeiro para preencher seletores de país e validar a entrada antes de chamar os endpoints de preços. A resposta é um array JSON de nomes de países.

2) Custo 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

Descrição: Retorna dados de custo de vida para um país específico. Atualizado frequentemente.

• Parâmetro de consulta necessário: country (string). Exemplo de valor: united states

Exemplo 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"

Resposta de exemplo 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…

O que procurar nesta resposta:

• Version, Status, Success: Metadados da resposta que você pode usar para verificações rápidas e monitoramento.
• Country Name: A string de país normalizada.
• Campos de preço itemizados: Strings legíveis por humanos, incluindo um símbolo de moeda (por exemplo, “$”) e unidades onde relevante.

3) Custo de Vida por Cidade 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

Descrição: Retorna dados de preços em nível de cidade. Atualizado frequentemente.

• Parâmetros de consulta necessários:
  • country (string). Exemplo de valor: United States
  • city (string). Exemplo de valor: Seattle, WA

Início rápido: obtenha todos os países disponíveis

Você pode chamar Obter Países V2 com apenas o cabeçalho de Autorização. Abaixo está um exemplo em Python que recupera a lista e a filtra para exibição na interface do usuário:

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 strings

# Exemplo: normalize e mostre os primeiros 20 para um componente de seleção
normalized = sorted(countries)
for c in normalized[:20]:
print(c)

Resposta de exemplo:

["Afeganistão","Ilhas Aland","Albânia","Alderney","Argélia","Samoa Americana","Andorra","Angola","Anguilla","Antígua e Barbuda","Argentina","Armênia","Aruba","Austrália","Áustria","Azerbaijão","Bahamas","Bahrein","Bangladesh","Barbados","Bielorrússia","Bélgica","Belize","Benin","Bermudas","Butão","Bolívia","Bonaire","Bósnia e Herzegovina","Botsuana","Brasil","Ilhas Virgens Britânicas","Brunei","Bulgária","Burkina Faso","Burundi","Camboja","Camarões","Canadá","Cabo Verde","Ilhas Cayman","República Centro-Africana","Chade","Chile","China","Colômbia","Comores","Ilhas Cook","Costa Rica","Croácia","Cuba","Curaçao","Chipre","República Tcheca","República Democrática do Congo","Dinamarca","Djibuti","Dominica","República Dominicana","Equador","Egito","El Salvador","Guiné Equatorial","Eritreia","Estônia","Eswatini","Etiópia","Ilhas Malvinas","Ilhas Faroe","Fiji","Finlândia","França","Guiana Francesa","Polinésia Francesa","Territórios do Sul da França","Gabão","Gâmbia","Geórgia","Alemanha","Gana","Gibraltar","Grécia","Groenlândia","Granada","Guadalupe","Guame","Guatemala","Guernsey","Guiné","Guiné-Bissau","Guiana","Haiti","Honduras","Hong Kong (China)","Hungria","Islândia","Índia","Indonésia","Irã…

Notas que economizam tempo:

• O formato da resposta é um array plano de strings. Nenhum campo de paginação é documentado para este endpoint.
• Use as strings de país fornecidas como estão ao chamar os endpoints de país ou cidade. Se seu aplicativo exigir capitalização de título ou localização, mapeie-as internamente, mas mantenha a string voltada para a API intacta.
• Cache esta lista de forma agressiva (por exemplo, 24 horas) e atualize na inicialização do aplicativo. Ela muda com muito menos frequência do que os preços por país.

Consultar preços por país

Para obter preços em todo o país, passe o parâmetro country exatamente como exigido pelo endpoint. O exemplo oficial abaixo busca os Estados Unidos. Copie-o e troque o parâmetro de consulta do país conforme necessário:

Analise as strings de resposta conforme necessário em sua interface do usuário. Os valores incluem um símbolo de moeda (por exemplo, “$”) e podem incluir unidades (por exemplo, “1 galão”, “1 lb”). Evite assumir campos apenas numéricos—extraia números com uma regex se precisar calcular agregados.

Consultar preços por cidade

Para obter insights em nível de cidade, envie os parâmetros de país e cidade. Mantenha a string do país consistente com o endpoint de países e garanta que sua entrada de cidade corresponda ao formato que você mantém em seu aplicativo (por exemplo, “Seattle, WA”).

Fluxo de trabalho recomendado:

1. Chame Obter Países V2 para preencher uma seleção de países.
2. Use sua própria lista de cidades por país, ou uma entrada validada, e então chame o endpoint da cidade com ambos os parâmetros.
3. Cache os resultados por cidade por curtos períodos para evitar repetir consultas idênticas.

Detalhes práticos de implementação

• Autenticação: Cabeçalho de Autorização com Bearer YOUR_API_KEY em cada solicitação.
• Unidades e moeda: Campos de preço são strings e incluem tanto números quanto símbolo de unidade/moeda (por exemplo, “$”). Apresente-os diretamente na interface do usuário; analise apenas se necessário.
• Cache: A lista de países pode ser armazenada em cache por longos períodos. Os preços de países e cidades são atualizados frequentemente; armazene em cache com um TTL mais curto se sua experiência do usuário permitir.
• Tratamento de erros: Verifique os campos Success e Status (onde presentes) para diagnósticos rápidos e use códigos de status HTTP para lógica de repetição/recuo.
• Quotas e cobrança: Modelo de assinatura + cota. A primeira API geralmente inclui um teste de 7 dias ou 50 solicitações—verifique os detalhes na página de listagem.

Casos de uso do mundo real que você pode enviar rapidamente

• Selecionador de país com preenchimento automático: Pré-carregue o array de países na inicialização, alimente-o na sua pesquisa de frontend e passe as seleções para os endpoints de preço.
• Planejador de orçamento de realocação: Após um usuário escolher um país ou cidade, busque campos de supermercado, aluguel e transporte para estimar um orçamento mensal.
• Estimador de custo de viagem: Combine preços de restaurantes, transporte e entretenimento para projetar gastos diários para itinerários.
• Widget de comparação de preços: Busque duas localizações e renderize uma diferença lado a lado para itens-chave da cesta (por exemplo, pão, leite, gasolina).

Chame a API de um agente de IA via MCP

Toda API no Zyla API Hub pode ser chamada de clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf) usando o endpoint MCP:

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

Forneça a URL exata do hub, método e cabeçalhos na configuração da sua ferramenta e encaminhe os parâmetros selecionados pelo usuário (por exemplo, país ou cidade) como strings de consulta. Para detalhes de configuração, veja MCP.

Referência: Resumo dos endpoints

• Obter Países V2
  • GET https://zylalabs.com/api/226/cities-cost-of-living-and-average-prices-api/6144/get-countries-v2
  • Nenhum parâmetro. Autorização necessária.
  • Retorna: array JSON de nomes de países.
• Custo 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, necessário). Exemplo: united states
  • Retorna: Objeto com metadados e campos de preço itemizados.
• Custo de Vida por Cidade 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, necessário), city (string, necessário). Exemplo: country=United States, city=Seattle, WA
  • Retorna: Objeto com nome da cidade e campos de preço itemizados.

FAQ

Como faço para autenticar?
Adicione o cabeçalho Authorization: Bearer YOUR_API_KEY a cada solicitação.

O que o Obter Países V2 retorna?
Um array JSON de nomes de países suportados pelos endpoints de preços. Nenhum parâmetro de consulta é necessário.

Em que moeda estão os preços?
Os preços são retornados como strings incluindo um símbolo de moeda (por exemplo, “$”) e às vezes unidades. Use-os diretamente na interface do usuário ou analise se precisar de números.

Posso armazenar em cache a lista de países?
Sim. Ela muda com pouca frequência em relação aos preços; armazená-la em cache por um dia (ou na inicialização) é típico.

Há um plano gratuito?
O acesso é por assinatura + cota. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações—verifique a página da API para opções de acesso e preços atuais.

Pronto para integrar? Crie sua conta, obtenha uma chave de API e comece com a lista de países. Em seguida, conecte consultas de país e cidade para alimentar sua interface com preços ao vivo. Comece aqui: Iniciar teste de 7 dias na API de Custo de Vida das Cidades e Preços Médios.

Resposta oficial da 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.000$","McMeal at McDonalds (or Equivalent Combo Meal)":"12.000$","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…

Resposta oficial da 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…