API de aeropuertos: base de datos de aeropuertos y códigos

Ayude a los viajeros a identificar el aeropuerto correcto y a entender dónde empieza y dónde termina su viaje. Consulte códigos de aeropuertos, nombres, ubicaciones y zonas horarias, o descargue el directorio para sus propias herramientas de búsqueda y reserva.

  • Consulta por código IATA e ICAO
  • Coordenadas y zonas horarias
  • JSON, XML y CSV

Consultar un aeropuerto por su código

Envíe iata=LHR para obtener el aeropuerto de Londres Heathrow y sus datos de referencia. Sustituya YOUR_API_KEY por su clave de API.

Descripción del endpoint

Este endpoint devuelve datos geográficos de un aeropuerto concreto o exporta toda la base de datos de aeropuertos. La respuesta llega en JSON, XML o CSV.

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

Solicitud · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'iata=LHR'

Respuesta · JSON

[
    {
        "airhex_id": "53779",
        "updated": "2025-09-03 13:16:53",
        "iata": "LHR",
        "icao": "EGLL",
        "name": "London Heathrow Airport",
        "city_code": "LON",
        "country_code": "GB",
        "timezone": "Europe\/London",
        "utc": "1",
        "latitude": "51.469603",
        "longitude": "-0.453566",
        "active": "1",
        "avg_weekly_flights": "1587",
        "major_airport": 1,
        "address": "Longford TW6, UK",
        "phone_local": "0844 335 1801",
        "phone_intl": "+44 844 335 1801",
        "website": "https:\/\/www.heathrow.com",
        "sub_type": null
    }
]

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 iata, icao, city_code, country_code, name o dump=1. Con dump=1 se ignoran los demás parámetros de consulta; los filtros de alcance siguen aplicándose.

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.
iata Condicional AAA-ZZZ String ninguno Código IATA de tres letras del aeropuerto
icao Condicional AAAA-ZZZZ String ninguno Código ICAO de cuatro letras del aeropuerto
city_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 del aeropuerto o parte del nombre para una coincidencia parcial
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)
show_disabled No 0 o 1 Integer 0 Indique 1 para incluir también los aeropuertos inactivos o desactivados. De forma predeterminada solo se devuelven los aeropuertos activos.
response_type No JSON, XML o CSV String JSON Formato de respuesta: JSON, XML o CSV (CSV inicia la descarga de un archivo)
major_only No 0 o 1 Integer 0 Indique 1 para incluir solo aeropuertos con vuelos comerciales (excluye bases de hidroaviones, helipuertos, bases militares, etc.)

Campos de la respuesta

Obtenga identificadores, datos de ubicación, estado operativo y datos de contacto de aeropuertos. Los campos con enlace llevan a guías con ejemplos y consejos de integración.

Campo Ejemplo Descripción
airhex_id 53779 Identificador único y permanente del registro
updated 2025-09-03 13:16:53 Fecha y hora de la última actualización del registro
iata LHR Código IATA de tres letras del aeropuerto
icao EGLL Código ICAO de cuatro letras del aeropuerto
name London Heathrow Airport Nombre del aeropuerto
city_code LON Código IATA de ciudad de tres letras de la ubicación del aeropuerto
country_code GB Código de país (ISO 3166-1 alfa-2) de la ubicación del aeropuerto
timezone Europe/London Identificador de zona horaria del aeropuerto
utc 1 Desfase horario del aeropuerto respecto a UTC
latitude 51.469603 Latitud geográfica del aeropuerto
longitude -0.453566 Longitud geográfica del aeropuerto
major_airport 1 Indica si el aeropuerto tiene vuelos comerciales regulares:
1 – aeropuerto con vuelos regulares
0 – aeropuerto sin vuelos regulares u otros tipos de ubicación (estaciones de tren, estaciones de autobús, helipuertos, etc.)
sub_type Subtipo de instalación (si no es un aeropuerto), p. ej., Rail, Bus/Limo, Ferry/Port o Border/Customs
active 1 Estado operativo: 1 activo; 0 inactivo
avg_weekly_flights 1587 Promedio semanal de vuelos regulares
address Longford TW6, UK Dirección física del aeropuerto
phone_local 0844 335 1801 Teléfono local del aeropuerto
phone_intl +44 844 335 1801 Teléfono internacional del aeropuerto, con prefijo de país
website https://www.heathrow.com URL del sitio web oficial del aeropuerto

Ejemplos de respuesta completos

Los ejemplos muestran el registro completo del aeropuerto de Londres Heathrow en JSON y XML. Elija el formato de salida con response_type.

Respuesta · JSON

[
    {
        "airhex_id": "53779",
        "updated": "2025-09-03 13:16:53",
        "iata": "LHR",
        "icao": "EGLL",
        "name": "London Heathrow Airport",
        "city_code": "LON",
        "country_code": "GB",
        "timezone": "Europe\/London",
        "utc": "1",
        "latitude": "51.469603",
        "longitude": "-0.453566",
        "active": "1",
        "avg_weekly_flights": "1587",
        "major_airport": 1,
        "address": "Longford TW6, UK",
        "phone_local": "0844 335 1801",
        "phone_intl": "+44 844 335 1801",
        "website": "https:\/\/www.heathrow.com",
        "sub_type": null
    }
]

Respuesta · XML

<?xml version="1.0" encoding="UTF-8"?>
<airports>
 <airport>
  <airhex_id>53779</airhex_id>
  <updated>2025-09-03 13:16:53</updated>
  <iata>LHR</iata>
  <icao>EGLL</icao>
  <name>London Heathrow Airport</name>
  <city_code>LON</city_code>
  <country_code>GB</country_code>
  <timezone>Europe/London</timezone>
  <utc>1</utc>
  <latitude>51.469603</latitude>
  <longitude>-0.453566</longitude>
  <active>1</active>
  <avg_weekly_flights>1587</avg_weekly_flights>
  <major_airport>1</major_airport>
  <address>Longford TW6, UK</address>
  <phone_local>0844 335 1801</phone_local>
  <phone_intl>+44 844 335 1801</phone_intl>
  <website>https://www.heathrow.com</website>
  <sub_type></sub_type>
 </airport>
</airports>

Tareas habituales de implementación

Descargar el directorio de aeropuertos

Exporte los aeropuertos activos con vuelos comerciales para su índice de búsqueda local. Conserve airhex_id y updated al importar los registros.

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

Encontrar los aeropuertos de una ciudad

Use el código de ciudad para obtener los aeropuertos asociados y conserve el código y el nombre de cada aeropuerto para las selecciones individuales.

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'city_code=LON' \
  --data-urlencode 'major_only=1'

Consultar un aeropuerto por su código ICAO

Asocie un identificador de aviación al mismo registro de aeropuerto que usan sus herramientas de reserva.

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'icao=EGLL'

Qué puede crear

Crear una búsqueda de aeropuertos más clara

Ayude a los viajeros a distinguir aeropuertos por nombre, código, ciudad y país.

Hacer comprensibles los datos de vuelo

Convierta los códigos de aeropuerto de su proveedor en lugares de salida y llegada claros en resultados, confirmaciones e itinerarios.

Añadir ubicación y hora local

Use las coordenadas para mapas de aeropuertos y los identificadores de zona horaria para mostrar la hora local.

Preguntas frecuentes

¿Puedo usar estos datos para el autocompletado de aeropuertos?

Sí. Descargue el directorio de aeropuertos y cree con él un índice de búsqueda local con nombres de aeropuertos, códigos IATA e ICAO, asociaciones con ciudades y países. Su aplicación controla la coincidencia y el orden de las sugerencias. El endpoint ofrece datos de referencia y consultas por nombre, no una interfaz de sugerencias ya hecha.

¿Cómo se mantienen actualizados los datos de aeropuertos?

Airhex combina datos geográficos de varias fuentes, los verifica y los revisa a diario. Actualice su directorio local de forma periódica y conserve airhex_id y updated para que los cambios se asocien a los mismos registros de aeropuertos.

¿En qué se diferencian los códigos de ciudad de los códigos de aeropuerto?

Use iata para un aeropuerto concreto, como LHR, y city_code para los aeropuertos de una ciudad, como LON. Una ciudad puede tener varios aeropuertos. Compruebe qué tipo de ubicación entrega su proveedor de reservas.

¿Qué aeropuertos se incluyen y puedo obtener registros inactivos?

De forma predeterminada solo se devuelven registros activos, sin limitarse a aeropuertos con vuelos comerciales. Para aplicar esa limitación use major_only=1, y con show_disabled=1 obtendrá también los registros inactivos o desactivados. Revise active, major_airport y sub_type antes de ofrecer registros en un selector de reservas.

¿Puedo guardar el directorio de aeropuertos en local?

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

¿Puedo usar el desfase UTC para cualquier fecha de viaje?

Use timezone junto con la marca de tiempo real del viaje y una biblioteca que tenga en cuenta las fechas. El campo utc es un desfase guardado en el registro; no refleja las reglas del horario de verano de cada fecha.

¿Las coordenadas son la posición de la terminal o del punto de recogida?

Las coordenadas describen la ubicación del aeropuerto. No las use como coordenadas de la terminal, la puerta de embarque o el punto de recogida. Para indicaciones de traslados terrestres, use datos de ubicación y de rutas más precisos.

¿Este endpoint devuelve vuelos en tiempo real o tarifas?

No. Ofrece datos de referencia de aeropuertos. Los horarios, la disponibilidad, las tarifas y el estado actual de los vuelos los obtiene de su proveedor de vuelos.

Para los detalles de implementación, consulte las guías de la API de zona horaria de aeropuertos y de la API de coordenadas de aeropuertos.

Ayude a los viajeros a encontrar y reconocer el aeropuerto correcto

Lleve opciones de aeropuerto claras, datos de ubicación y la hora local a su proceso de reserva, mientras Airhex mantiene los datos de referencia de aeropuertos.