Country by IP Address API

Introduction

This API returns detailed information about the country identified by geolocating the provided IPv4 IP address. This includes ISO defined names, languages, currencies, United Nations and Word Bank defined region names and income levels. Powered by patent pending Next Generation IP Geolocation Technology.

Unprecedented Update Rate

Geolocation data: re-evaluated every 2 hours or at least once daily

Country object data: usually updates at least once a month

Example Response

The response is only available in JSON format. The below response should be expected for the following request:


https://api.bigdatacloud.net/data/country-by-ip


Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$2.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.60/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
ip IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed
localityLanguage

Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided
key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.

The live query

https://api.bigdatacloud.net/data/country-by-ip


CURL Example

curl -X GET --header 'Accept: application/json' 'https://api.bigdatacloud.net/data/country-by-ip'


Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.


Response

Awaiting request submission...

Response Format

Field

Data type

Description

ip

string

Requested IPv4 IP address in a string format

localityLanguageRequested

string

localityLanguage input parameter received

country

<Country> object

Geolocated Country

API Endpoint

Endpoint: /data/country-by-ip
Full URL: https://api.bigdatacloud.net/data/country-by-ip

Data Objects

Country object

Field

Data type

Description

isoAlpha2

string

ISO 3166-1 Alpha-2 code

isoAlpha3

string

ISO 3166-1 Alpha-3 code

m49Code

16 bit integer

United Nations M.49 code

name

string

Country name localised to the language as defined by ‘localityLanguage’ request parameter

isoName

string

ISO 3166-1 Country name

isoAdminLanguages

Array of <Language> objects

Administrative languages as defined by ISO 3166-1 standard

unRegion

string

Region name as defined by United Nations

currency

<Currency> object

Currency as defined by ISO 4217 standard

wbRegion

<WbNode> object

Region name as defined by World Bank

wbIncomeLevel

<WbNode> object

Income level as defined by World Bank

callingCode

string

Calling code

countryFlagEmoji

string

Country emoji

Language object

Field

Data type

Description

isoAlpha2

string

ISO 3166-1 Alpha-2 code

isoAlpha3

string

ISO 3166-1 Alpha-3 code

isoName

string

ISO 3166-1 Language name

nativeName

string

Language native name

Currency object

Field

Data type

Description

numericCode

string

ISO 4217 standard numeric code

code

string

ISO 4217 standard code

Name

string

ISO 4217 English name

minorUnits

byte

ISO 4217 minor units as the currency exponent  (e.g. 2 = 1/100)

WbNode object

Field

Data type

Description

id

string

Identification number

iso2Code

string

ISO 2 letters code

value

string

Value

Related APIs

  1. IP Address Geolocation API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$2.00
    /month

    Returns detailed geolocation for a provided IPv4 IP address

    • Lightning fast (sub-millisecond response time)
    • Country data
    • Detailed locality data
    • Estimated location coordinates
    • Network data
    • Registration data
    • BGP prefix and status data
    • Next Generation IP Geolocation Technology
    Read More
  2. IP Address Geolocation with Confidence Area API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$2.00
    /month

    Returns detailed geolocation for an IPv4 IP address including confidence and area estimation

    • Lightning fast (sub-millisecond response time)
    • Country data
    • Detailed locality data
    • Estimated location coordinates
    • Network data
    • Registration data
    • BGP prefix and status data
    • Next Generation IP Geolocation Technology
    • Confidence and area estimation
    Read More
  3. IP Address Geolocation with Confidence Area and Hazard Report API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$3.00
    /month

    Returns detailed geolocation for an IPv4 IP address including confidence and area estimation and IP address Hazard report

    • Lightning fast (sub-millisecond response time)
    • Country data
    • Detailed locality data
    • Estimated location coordinates
    • Network data
    • Registration data
    • BGP prefix and status data
    • Next Generation IP Geolocation Technology
    • Confidence and area estimation
    • Hazard report
    Read More
  4. Time Zone by IP Address API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$2.00
    /month

    Returns detailed time-zone information when provided with an IPV4 IP address.

    • Lightning fast (sub-millisecond response time)
    • Daylight saving
    • Local time
    • Past/future time
    • Next Generation IP Geolocation Technology
    Read More
  5. Country Info API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$1.00
    /month

    Returns detailed information about World Countries by ISO code

    • Very fast
    • ISO 3166-1
    • UN data
    • World Bank data
    Read More

Sidebar