Country Info API
Introduction
The Country Info API offered by BigDataCloud delivers speedy, precise, and up-to-date comprehensive information regarding a country's ISO-defined names, languages, currencies, calling codes, and flags, in addition to standard region names and income levels defined by United Nations and World Bank.
This API provides access to country codes based on the ISO 3166-1 system, including the isoAlpha-2, isoAlpha-3, and ISO 3166-1 or m49Code, which utilise two-letter, three-letter, and three-digit country codes respectively, for countries that don't use the Roman alphabet.
By taking these iso-codes as input, this API delivers detailed country information and has a feature that generates localised names according to your preferences.
The country data available through this API serves a wide range of purposes, including facilitating the auto-completion of forms based on user input or creating localised content for basic websites, as well as supporting crucial operations like ensuring correct country labelling of physical assets for large enterprises such as logistic companies. Additionally, travel and tourism websites, Saas platforms and financial institutions are some of the other domains where this API can be leveraged for its benefits.
Get started
This API is part of the IP Geolocation package and is available in free and paid plans. Please visit the IP Geolocation package page for limits and pricing information.
Endpoints
IPv4 only API Endpoint
Use this endpoint to force API calls routed over the IPv4 network only
Dual-Stack API Endpoint
This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks
Request
Responses
Example query
https://api-bdc.net/data/country-info?code=au&localityLanguage=en&key=[YOUR API KEY]
Example response
Schema
ISO 3166-1 Alpha-2 code
ISO 3166-1 Alpha-3 code
United Nations M.49 code
Country name localised to the language as defined by 'localityLanguage' request parameter
ISO 3166-1 Country name short
ISO 3166-1 Country name full
Administrative languages as defined by ISO 3166-1 standard
Region name as defined by the United Nations
currency object
wbRegion object
wbIncomeLevel object
Calling code
Country emoji
Wikidata item identifier, if available
A unique identifier as is given by GeoNames.org
The list of Continents the Country belong to