Länder-API: Datenbank der Länder und Codes

Halten Sie Länderinformationen in Ihrem Reiseprodukt einheitlich. Ordnen Sie Länderkennungen Namen und geografischen Details zu oder laden Sie das Verzeichnis herunter – für Zielfilter, Formulare und Auswertungen.

API-TestschlüsselBeispiel ansehen
  • Abfrage per Alpha-2, Alpha-3 und numerischem ISO-Code
  • Einzelabfrage oder Gesamtexport
  • JSON, XML und CSV

Land über seinen Code abfragen

Senden Sie code2=US, um die Vereinigten Staaten samt Referenzdaten abzurufen. Ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel.

Beschreibung des Endpunkts

Dieser Endpunkt liefert Details zu einzelnen Ländern oder exportiert die gesamte Länder-Datenbank als JSON-, XML- oder CSV-Datei.

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

Anfrage · cURL

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

Antwort · 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"
    }
]

Vollständige JSON-Antwort. Scrollen Sie im Feld, um alle Felder zu sehen. Weiter unten finden Sie erweiterte JSON- und XML-Beispiele.

Anfrageparameter

Geben Sie mindestens einen der Parameter code2, code3, iso, name oder dump=1 an. Mit dump=1 werden die übrigen Abfrageparameter ignoriert.

Parameter Pflicht Wert Typ Standard Beschreibung
apikey Ja Beliebig String keiner Ihr API-Schlüssel. Kostenlosen API-Testschlüssel anfordern.
code2 Bedingt AA-ZZ String keiner Zweistelliger Ländercode nach ISO 3166-1 Alpha-2
code3 Bedingt AAA-ZZZ String keiner Dreistelliger Ländercode nach ISO 3166-1 Alpha-3
iso Bedingt Beliebig Int keiner Numerischer Ländercode nach ISO 3166-1
name Bedingt Beliebig String keiner Ländername oder Teilstring für die Suche
dump Bedingt 0 oder 1 Integer 0 Auf 1 setzen, um die gesamte Datenbank zu exportieren (ignoriert die anderen bedingten Parameter oben)
response_type Nein JSON oder XML oder CSV String JSON Antwortformat: JSON, XML oder CSV (CSV startet einen Dateidownload)

Antwortfelder

Rufen Sie Länderkennungen, Namen und geografische Referenzdetails aus demselben Datensatz ab. Mit den dokumentierten Feldern halten Sie Länderzuordnungen in Ihren Systemen einheitlich.

Feld Beispiel Beschreibung
airhex_id 735 Eindeutige, dauerhafte Kennung des Datensatzes
updated 2026-06-16 14:48:41 Datum und Uhrzeit der letzten Aktualisierung des Datensatzes
iso 840 Numerischer Ländercode nach ISO 3166-1
code2 US Zweistelliger Ländercode nach ISO 3166-1 Alpha-2
code3 USA Dreistelliger Ländercode nach ISO 3166-1 Alpha-3
name United States Name des Landes
capital_code WAS Dreistelliger IATA-Code der Hauptstadt des Landes
currency_code USD Dreistelliger ISO-Währungscode
region North America Geografische Region des Landes
continent_code NA Zweistelliger Kontinentcode
population 310232863 Einwohnerzahl des Landes
phone_code +1 Internationale Landesvorwahl

Vollständige Antwortbeispiele

Die Beispiele zeigen den vollständigen Datensatz der Vereinigten Staaten als JSON und XML. Das Ausgabeformat wählen Sie mit response_type.

Antwort · 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"
    }
]

Antwort · 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>

Häufige Aufgaben

Länderverzeichnis herunterladen

Exportieren Sie die Länder als CSV für Ihre lokalen Formulare und Zielfilter. Behalten Sie beim Import airhex_id und updated bei.

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

Dreistelligen Ländercode zuordnen

Verwenden Sie code3, wenn ein Lieferant Alpha-3-Kennungen sendet, und lesen Sie den passenden code2-Wert aus der Antwort.

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

Nach Ländernamen suchen

Verwenden Sie name für die Suche nach dem vollständigen oder einem Teil des Namens. Prüfen Sie die zurückgegebenen Kennungen, bevor Sie einen Treffer auswählen.

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

Einsatzmöglichkeiten

Einheitliche Länderauswahl bauen

Verwenden Sie bekannte Ländernamen und standardisierte Kennungen in Formularen und Zielfiltern.

Nützlichen Destinationskontext ergänzen

Nehmen Sie Währung und Landesvorwahl in Länderführer und Reiseplanungsansichten auf.

Geodaten im ganzen Produkt verbinden

Ordnen Sie Länder Städten, Flughäfen und Lieferantendatensätzen zu – für einheitliches Filtern und Auswerten.

Häufige Fragen

Wie hängen Länderdaten mit Flughäfen und Städten zusammen?

Die Städte- und die Flughafen-API liefern country_code als zweistellige ISO-Kennung. Ordnen Sie diesen Wert code2 in der Länder-API zu, um Ländernamen und weitere Referenzdetails abzurufen. Behalten Sie die airhex_id jedes Datensatzes als Kennung bei.

Welche Länderdetails kann ich in meinem Reiseprodukt anzeigen?

Neben Ländernamen und ISO-Kennungen enthält die Antwort currency_code, phone_code, capital_code, region, continent_code und population. Nutzen Sie sie für den Destinationskontext und die geografische Gruppierung. Währungscodes sind Referenzwerte, keine Wechselkurse; capital_code ist eine Kennung und kein Anzeigename.

Wie werden die Länderdaten aktuell gehalten?

Airhex führt geografische Daten aus mehreren Quellen zusammen, gleicht sie ab und prüft sie täglich. Behalten Sie airhex_id und updated bei und aktualisieren Sie Ihr lokales Verzeichnis in regelmäßigen Abständen. Die tägliche Prüfung bedeutet nicht, dass sich jedes Feld jedes Landes täglich ändert.

Über welche Ländercode-Formate kann ich abfragen?

Verwenden Sie code2 für zweistellige ISO-Alpha-2-Codes, code3 für dreistellige Alpha-3-Codes oder iso für numerische ISO-Ländercodes. Die Antwort enthält die jeweils entsprechenden Kennungen des Landes.

Kann ich ein Land über seinen Namen finden?

Ja. Der Parameter name unterstützt Teilübereinstimmungen. Vergleichen Sie die zurückgegebenen Ländernamen und Codes, bevor Sie einen Datensatz auswählen.

Kann ich das Länderverzeichnis herunterladen und speichern?

Ja, mit einer passenden GEO-Essentials-Lizenz. Setzen Sie dump=1 und wählen Sie mit response_type JSON, XML oder CSV. Behalten Sie airhex_id und updated bei und aktualisieren Sie Ihre lokale Kopie in regelmäßigen Abständen.

Liefert diese API Visa- oder Einreisebestimmungen?

Nein. Sie liefert Referenzdaten zu Ländern. Aktuelle Visaregeln, Einreisebestimmungen und Reisebeschränkungen erfahren Sie bei einer geeigneten Fachstelle oder einer offiziellen Quelle.

Einheitliche Länderinformationen für jede Reise

Verbinden Sie Zielfilter, Formulare für Reisende und Länderführer mit gepflegten Ländercodes und nützlichen Destinationsdetails.

API-TestschlüsselAngebot anfordern →