Menü

Dokumentation

Land suchen nach seiner Postleitzahl

Country Data API bietet detaillierte Informationen über +200 verschiedene Länder

HTTP GET

https://api.countrydataapi.com/v1/countries/zipCode

Gibt das Land zurück, das den angegebenen Postleitzahl enthält.

Es gibt 4 Arten von Operationen:

  • BASIC: Es werden die Felder id, lang, country_name, country_short_iso, country_phone_code, country_cca2, country_ccn3, country_cca3, country_cioc zurückgegeben.

  • NORMAL: Zusätzlich zu den oben genannten Feldern werden country_independent, country_status, country_unMember, country_flag, country_map_googleMaps, country_map_openStreetMaps, country_fifa, country_flag_png, country_flag_svg, country_flag_alt, country_coatOfArms_png, country_coatOfArms_svg, country_startofWeek, country_continent_code, country_current_currency, country_GDP, country_location, country_land, country_terrain, country_climate, country_natural_hazards, country_note, country_history, country_GDP_per_capita_PPP, country_life_expectancy, country_median_age, country_birth_rate, country_death_rate, country_sex_ratio, country_literacy, country_roadways, country_airports, country_railways, country_waterways, country_heliports, country_airports_paved, country_wikipedia_url zurückgegeben.

  • ADVANCED: Zusätzlich zu den oben genannten Feldern werden country_car_info, country_idd_info zurückgegeben.

  • ALL: Zusätzlich zu den oben genannten Feldern werden country_tld, country_capital, country_altSpellings, country_latLng, country_borders, country_timezones, country_continents, country_currencies, country_languages, country_translations, country_capital_info, country_demonyms, country_name_additional_info zurückgegeben.

Jede BASIC-Anfrage kostet 10 Tokens.

Jede NORMAL-Anfrage kostet 25 Tokens.

Jede ADVANCED-Anfrage kostet 40 Tokens.

Jede ALL-Anfrage kostet 75 Tokens.

Query Params

ParameterTypBeschreibung
apikeyerforderlich, TokenAuthentifizierungsschlüssel für das Konto
postalCodeerforderlich, ZahlPostleitzahl, nach der gesucht werden soll
limitTokenoptional, Zahl1000 (Standard). Maximale Anzahl von Ländern, die zurückgegeben werden können
langoptional, Spracheen (Standard). Erwartete Sprache der Antwort
typeoptional, Zeichenkettebasic (Standard), normal, advanced oder all

Beispielantwort


    [
        {
          "id": "33be30c5-80fc-429d-bf10-bd11f2e3e84c",
          "lang": "en",
          "country_name": "Albania",
          "country_short_iso": "AL",
          "country_phone_code": "355",
          "country_tld": [".al"],
          "country_cca2": "AL",
          "country_ccn3": "008",
          "country_cca3": "ALB",
          "country_cioc": "ALB",
          "country_independent": true,
          "country_status": "officially-assigned",
          "country_unMember": true,
          "country_capital": ["Tirana"],
          "country_altSpellings": ["AL", "Shqipëri", "Shqipëria", "Shqipnia"],
          "country_region": "Europe",
          "country_subregion": "Southeast Europe",
          "country_latLng": ["41", "20"],
          "country_landlocked": null,
          "country_borders": ["MNE", "GRC", "MKD", "UNK"],
          "country_area": "28748",
          "country_flag": "🇦🇱",
          "country_map_googleMaps": "https://goo.gl/maps/BzN9cTuj68ZA8SyZ8",
          "country_map_openStreetMaps": "https://www.openstreetmap.org/relation/53292",
          "country_population": "2837743",
          "country_fifa": "ALB",
          "country_timezones": ["UTC+01:00"],
          "country_continents": ["Europe"],
          "country_flag_png": "https://flagcdn.com/w320/al.png",
          "country_flag_svg": "https://flagcdn.com/al.svg",
          "country_flag_alt": "The flag of Albania features a silhouetted double-headed black eagle at the center of a red field.",
          "country_coatOfArms_png": "https://mainfacts.com/media/images/coats_of_arms/al.png",
          "country_coatOfArms_svg": "https://mainfacts.com/media/images/coats_of_arms/al.svg",
          "country_startofWeek": "monday",
          "country_continent_code": "EU",
          "country_currencies": [
            {
              "currency": "ALL",
              "name": "Albanian lek",
              "symbol": "L",
            }
          ],
          "country_languages": [
            {
              "language": "sqi",
              "name": "Albanian",
            }
          ],
          "country_translations": [
            {
              "translation": "ara",
              "official": "جمهورية ألبانيا",
              "common": "ألبانيا",
            },
            ...
          ],
          "country_car_info": {
            "signs": ["AL"],
            "side": "right",
          },
          "country_capital_info": [
            {
              "lat": "41.32",
              "lng": "19.82",
            }
          ],
          "country_demonyms": [
            {
              "lang": "eng",
              "f": "Albanian",
              "m": "Albanian",
            },
            {
              "lang": "fra",
              "f": "Albanaise",
              "m": "Albanais",
            }
          ],
          "country_name_additional_info": {
            "common": "Albania",
            "official": "Republic of Albania",
            "nativeName": [
              {
                "lang": "SQI",
                "official": "Republika e Shqipërisë",
                "common": "Shqipëria",
              }
            ],
          },
          "country_idd_info": {
            "root": "+3",
            "suffixes": ["55"],
          },
          "country_current_currency": "Lek (ALL)",
          "country_GDP": "$21.8 billion",
          "country_location": "Southeastern Europe bordering the Adriatic Sea and Ionian Sea between Greece in the south and Montenegro and Kosovo to the north",
          "country_land": "28,748 km2",
          "country_terrain": "Mostly mountains and hills; small plains along coast",
          "country_climate": "Mild temperate; cool cloudy wet winters; hot clear dry summers; interior is cooler and wetter",
          "country_natural_hazards": "Mostly mountains and hills; small plains along coast",
          "country_note": "Strategic location along Strait of Otranto (links Adriatic Sea to Ionian Sea and Mediterranean Sea)",
          "country_history": "Albania declared its independence from the Ottoman Empire in 1912 but was conquered by Italy in 1939. Communist partisans took over the country in 1944. Albania allied itself first with the USSR (until 1960) and then with China (to 1978). In the early 1990s Albania ended 46 years of xenophobic Communist rule and established a multiparty democracy. The transition has proven challenging as successive governments have tried to deal with high unemployment widespread corruption a dilapidated physical infrastructure powerful organized crime networks and combative political opponents. Albania has made progress in its democratic development since first holding multiparty elections in 1991, but deficiencies remain. International observers judged elections to be largely free and fair since the restoration of political stability following the collapse of pyramid schemes in 1997; however, there have been claims of electoral fraud in every one of Albania's post-communist elections. In the 2005 general elections, the Democratic Party and its allies won a decisive victory on pledges to reduce crime and corruption, promote economic growth, and decrease the size of government. The election and particularly the orderly transition of power was considered an important step forward. Albania joined NATO in April 2009 and is a potential candidate for EU accession. Although Albania's economy continues to grow, the country is still one of the poorest in Europe, hampered by a large informal economy and an inadequate energy and transportation infrastructure.",
          "country_GDP_per_capita_PPP": "$6000",
          "country_life_expectancy": "77.96 years",
          "country_median_age": "29.9 years",
          "country_birth_rate": "15.29 births/1,000 population",
          "country_death_rate": "5.55 births/1,000 population",
          "country_sex_ratio": "0.87 male(s)/female",
          "country_literacy": "98.7%",
          "country_roadways": "18000 km",
          "country_airports": 8,
          "country_railways": 8,
          "country_waterways": "43 km",
          "country_heliports": 1,
          "country_airports_paved": 3,
          "country_wikipedia_url": "http://en.wikipedia.org/wiki/History_of_Albania",
        }
      ]