API de países: base de datos de países y códigos

Mantenga coherente la información de países en su producto de viajes. Asocie los identificadores de país con nombres y datos geográficos, o descargue el directorio para filtros de destinos, formularios e informes.

Clave de prueba de APIVer el ejemplo
  • Consulta por código alfa-2, alfa-3 y código ISO numérico
  • Consulta individual o exportación completa
  • JSON, XML y CSV

Consultar un país por su código

Envíe code2=US para obtener Estados Unidos y sus datos de referencia. Sustituya YOUR_API_KEY por su clave de API.

Descripción del endpoint

Este endpoint devuelve datos de países concretos o exporta toda la base de datos de países en un archivo JSON, XML o CSV.

Endpoint
GET https://content.airhex.com/api/v3.7.10/countries/

Solicitud · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'code2=US'

Respuesta · JSON

[
    {
        "airhex_id": "735",
        "updated": "2026-06-16 14:48:41",
        "iso": "840",
        "code2": "US",
        "code3": "USA",
        "name": "United States",
        "capital_code": "WAS",
        "currency_code": "USD",
        "region": "North America",
        "continent_code": "NA",
        "population": "310232863",
        "phone_code": "+1"
    }
]

Respuesta JSON completa. Desplácese dentro del recuadro para ver todos los campos. Más abajo encontrará ejemplos ampliados en JSON y XML.

Parámetros de la solicitud

Indique al menos uno de los parámetros code2, code3, iso, name o dump=1. Con dump=1 se ignoran los demás parámetros de consulta.

Parámetro Obligatorio Valor Tipo Predeterminado Descripción
apikey Sí Cualquiera String ninguno Su clave de API. Solicitar una clave de prueba de API gratuita.
code2 Condicional AA-ZZ String ninguno Código de país de dos letras según ISO 3166-1 alfa-2
code3 Condicional AAA-ZZZ String ninguno Código de país de tres letras según ISO 3166-1 alfa-3
iso Condicional Cualquiera Int ninguno Código numérico de país según ISO 3166-1
name Condicional Cualquiera String ninguno Nombre del país o parte del nombre para la búsqueda
dump Condicional 0 o 1 Integer 0 Indique 1 para exportar toda la base de datos (ignora los demás parámetros condicionales de arriba)
response_type No JSON, XML o CSV String JSON Formato de respuesta: JSON, XML o CSV (CSV inicia la descarga de un archivo)

Campos de la respuesta

Obtenga identificadores de país, nombres y datos geográficos de referencia del mismo registro. Con los campos documentados mantendrá coherentes las asociaciones de países en sus sistemas.

Campo Ejemplo Descripción
airhex_id 735 Identificador único y permanente del registro
updated 2026-06-16 14:48:41 Fecha y hora de la última actualización del registro
iso 840 Código numérico de país según ISO 3166-1
code2 US Código de país de dos letras según ISO 3166-1 alfa-2
code3 USA Código de país de tres letras según ISO 3166-1 alfa-3
name United States Nombre del país
capital_code WAS Código IATA de tres letras de la capital del país
currency_code USD Código ISO de moneda de tres letras
region North America Región geográfica del país
continent_code NA Código de continente de dos letras
population 310232863 Población del país
phone_code +1 Prefijo telefónico internacional del país

Ejemplos de respuesta completos

Los ejemplos muestran el registro completo de Estados Unidos en JSON y XML. Elija el formato de salida con response_type.

Respuesta · JSON

[
    {
        "airhex_id": "735",
        "updated": "2026-06-16 14:48:41",
        "iso": "840",
        "code2": "US",
        "code3": "USA",
        "name": "United States",
        "capital_code": "WAS",
        "currency_code": "USD",
        "region": "North America",
        "continent_code": "NA",
        "population": "310232863",
        "phone_code": "+1"
    }
]

Respuesta · XML

<?xml version="1.0" encoding="UTF-8"?>
<countries>
 <country>
  <airhex_id>735</airhex_id>
  <updated>2026-06-16 14:48:41</updated>
  <iso>840</iso>
  <code2>US</code2>
  <code3>USA</code3>
  <name>United States</name>
  <capital_code>WAS</capital_code>
  <currency_code>USD</currency_code>
  <region>North America</region>
  <continent_code>NA</continent_code>
  <population>310232863</population>
  <phone_code>+1</phone_code>
 </country>
</countries>

Tareas habituales de implementación

Descargar el directorio de países

Exporte los países como CSV para sus formularios y filtros de destinos locales. Conserve airhex_id y updated al importar.

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'dump=1' \
  --data-urlencode 'response_type=CSV' \
  --output countries.csv

Asociar un código de país de tres letras

Use code3 cuando un proveedor envíe identificadores alfa-3 y lea el valor code2 correspondiente de la respuesta.

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'code3=USA'

Buscar por nombre de país

Use name para buscar por el nombre completo o por una parte. Revise los identificadores devueltos antes de elegir un resultado.

curl --get 'https://content.airhex.com/api/v3.7.10/countries/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'name=United States'

Qué puede crear

Crear selectores de países coherentes

Use nombres de países conocidos e identificadores estandarizados en formularios y filtros de destinos.

Añadir contexto útil del destino

Incluya la moneda y el prefijo telefónico en guías de países y vistas de planificación de viajes.

Conectar los datos geográficos de todo el producto

Asocie países con ciudades, aeropuertos y registros de proveedores para filtrar e informar de forma coherente.

Preguntas frecuentes

¿Cómo se relacionan los datos de países con los de aeropuertos y ciudades?

Las API de ciudades y de aeropuertos devuelven country_code como identificador ISO de dos letras. Asocie ese valor con code2 en la API de países para obtener los nombres de países y otros datos de referencia. Conserve el airhex_id de cada registro como identificador.

¿Qué datos de país puedo mostrar en mi producto de viajes?

Además de los nombres de países y los identificadores ISO, la respuesta incluye currency_code, phone_code, capital_code, region, continent_code y population. Úselos para el contexto del destino y la agrupación geográfica. Los códigos de moneda son valores de referencia, no tipos de cambio; capital_code es un identificador, no un nombre para mostrar.

¿Cómo se mantienen actualizados los datos de países?

Airhex combina datos geográficos de varias fuentes, los verifica y los revisa a diario. Conserve airhex_id y updated, y actualice su directorio local de forma periódica. La revisión diaria no significa que cada campo de cada país cambie todos los días.

¿Con qué formatos de código de país puedo consultar?

Use code2 para los códigos ISO alfa-2 de dos letras, code3 para los códigos alfa-3 de tres letras o iso para los códigos numéricos ISO de país. La respuesta incluye los demás identificadores correspondientes del país.

¿Puedo encontrar un país por su nombre?

Sí. El parámetro name admite coincidencias parciales. Compare los nombres y códigos de país devueltos antes de elegir un registro.

¿Puedo descargar y guardar el directorio de países?

Sí, con una licencia adecuada de GEO Essentials. Establezca dump=1 y elija JSON, XML o CSV con response_type. Conserve airhex_id y updated, y actualice su copia local de forma periódica.

¿Esta API ofrece requisitos de visado o de entrada?

No. Ofrece datos de referencia de países. Para conocer las normas de visado vigentes, los requisitos de entrada y las restricciones de viaje, consulte a un especialista adecuado o a una fuente oficial.

Información de países coherente para cada viaje

Conecte los filtros de destinos, los formularios para viajeros y las guías de países con códigos de país actualizados y datos de destinos útiles.

Clave de prueba de APISolicitar cotización →