Convierta los códigos de destino en lugares que los viajeros reconocen. Consulte nombres de ciudades, datos de país y de estado, coordenadas y zonas horarias, o descargue el directorio para la búsqueda de destinos de su producto de viajes.
Envíe code=NYC para obtener Nueva York y sus datos de referencia. Sustituya YOUR_API_KEY por su clave de API.
Obtenga datos geográficos y demográficos de ciudades concretas o exporte toda la base de datos de ciudades en JSON, XML o CSV.
EndpointGET https://content.airhex.com/api/v3.7.10/cities/
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'code=NYC'[
{
"airhex_id": "5333",
"updated": "2025-10-23 05:47:19",
"code": "NYC",
"country_code": "US",
"name": "New York City",
"state_short": "NY",
"state_full": "New York",
"latitude": "40.7143528",
"longitude": "-74.0059731",
"city_photo": "https:\/\/content.airhex.com\/content\/city_photos\/5333.jpg",
"timezone": "America\/New_York",
"gmt": "-4",
"population": "8992908",
"popularity": "39128143"
}
]Respuesta JSON completa. Desplácese dentro del recuadro para ver todos los campos. Más abajo encontrará ejemplos ampliados en JSON y XML.
Indique al menos uno de los parámetros code, country_code, 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. |
| code | Condicional | AAA-ZZZ | String | ninguno | Código IATA de ciudad de tres letras |
| country_code | Condicional | AA-ZZ | String | ninguno | Código de país de dos letras según ISO 3166-1 alfa-2 |
| name | Condicional | Cualquiera | String | ninguno | Nombre de la ciudad 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) |
Obtenga identificadores, datos geográficos, imágenes de destinos y campos demográficos de ciudades. Los campos con enlace llevan a guías con ejemplos y consejos de integración.
| Campo | Ejemplo | Descripción |
|---|---|---|
| airhex_id | 5333 | Identificador único y permanente del registro |
| updated | 2025-10-23 05:47:19 | Fecha y hora de la última actualización del registro |
| code | NYC | Código IATA de tres letras de la ciudad |
| country_code | US | Código de país según ISO 3166-1 alfa-2 |
| name | New York City | Nombre de la ciudad |
| state_short | NY | Abreviatura del estado o provincia (solo ciudades de US, CA y AU) |
| state_full | New York | Nombre completo del estado o provincia (solo ciudades de US, CA y AU) |
| latitude | 40.7143528 | Latitud geográfica del centro de la ciudad |
| longitude | -74.0059731 | Longitud geográfica del centro de la ciudad |
| city_photo | https://content.airhex.com/content/city_photos/5333.jpg | URL de una imagen de la ciudad con licencia para uso comercial |
| timezone | America/New_York | Identificador de zona horaria de la ciudad |
| gmt | -4 | Desfase horario de la ciudad respecto a GMT |
| population | 8992908 | Población de la ciudad |
| popularity | 39128143 | Índice relativo de popularidad (un valor más alto indica un destino más popular) |
Los ejemplos muestran el registro completo de Nueva York en JSON y XML. Elija el formato de salida con response_type.
[
{
"airhex_id": "5333",
"updated": "2025-10-23 05:47:19",
"code": "NYC",
"country_code": "US",
"name": "New York City",
"state_short": "NY",
"state_full": "New York",
"latitude": "40.7143528",
"longitude": "-74.0059731",
"city_photo": "https:\/\/content.airhex.com\/content\/city_photos\/5333.jpg",
"timezone": "America\/New_York",
"gmt": "-4",
"population": "8992908",
"popularity": "39128143"
}
]<?xml version="1.0" encoding="UTF-8"?>
<cities>
<city>
<airhex_id>5333</airhex_id>
<updated>2025-10-23 05:47:19</updated>
<code>NYC</code>
<country_code>US</country_code>
<name>New York City</name>
<state_short>NY</state_short>
<state_full>New York</state_full>
<latitude>40.7143528</latitude>
<longitude>-74.0059731</longitude>
<city_photo>https://content.airhex.com/content/city_photos/5333.jpg</city_photo>
<timezone>America/New_York</timezone>
<gmt>-4</gmt>
<population>8992908</population>
<popularity>39128143</popularity>
</city>
</cities>
Exporte el conjunto de datos de ciudades para un selector de destinos local. Conserve airhex_id y updated junto con los códigos, los nombres y los datos de ubicación.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'dump=1' \
--data-urlencode 'response_type=CSV' \
--output cities.csvCree una lista de ciudades de un país concreto con su código de país de dos letras.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'country_code=US'Una búsqueda parcial por nombre puede devolver varias ciudades. Compare el país y los datos de estado disponibles antes de elegir un destino.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=New York'Ordene las sugerencias de su propia búsqueda de destinos con nombres de ciudades, contexto de país y valores de popularidad.
Ilustre las fichas de destinos y las guías de viaje con las fotos de ciudades con licencia disponibles.
Admita búsquedas a nivel de ciudad junto con aeropuertos individuales, con una etiqueta clara para cada opción.
Sí. Use popularity como señal relativa de orden en su aplicación; los valores más altos indican un destino más popular. Combine el valor con su propia coincidencia de texto y con el contexto de ubicación. El campo no ofrece recomendaciones personalizadas ni un algoritmo completo de sugerencias.
El campo city_photo ofrece las URL de fotos de destinos con licencia que existan, para uso comercial dentro de su licencia de GEO Essentials. No todas las ciudades tienen imagen: compruebe que haya una URL y prevea una imagen alternativa para las ciudades sin foto. Use las imágenes dentro de los derechos de uso acordados para su producto.
Airhex combina datos geográficos de varias fuentes, los verifica y los revisa a diario. Al importar registros de ciudades, 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 ciudad cambie todos los días.
Sí, con una licencia adecuada de GEO Essentials. Exporte con dump=1 y response_type en JSON, XML o CSV. Conserve airhex_id y updated, y actualice sus registros locales de forma periódica.
No. Obtenga los registros de aeropuertos asociados con la API de aeropuertos y city_code. Compruebe cómo trata su proveedor de vuelos las búsquedas a nivel de ciudad antes de ofrecer la opción “Todos los aeropuertos”.
La búsqueda por nombre admite coincidencias parciales. Compare name, country_code y los campos de estado disponibles, en lugar de elegir automáticamente el primer resultado.
state_short y state_full se aplican a las ciudades de Estados Unidos, Canadá y Australia. Cuente con valores vacíos y use el nombre de la ciudad y el país como contexto básico para mostrar.
Use code, por ejemplo code=NYC. La API de ciudades no usa iata como parámetro de consulta.
Use timezone junto con la marca de tiempo correspondiente y las reglas de zona horaria vigentes. No trate el desfase gmt como un desfase fijo para cualquier fecha.
El directorio ofrece datos de referencia de destinos. No dice nada sobre cobertura de rutas, tarifas ni disponibilidad; esos datos los obtiene de su proveedor de reservas.
Cree sugerencias de destinos más claras y vistas de ciudad más atractivas con códigos de ciudad, datos de popularidad y las fotos con licencia disponibles.