Get the geolocation data of the IP addresses set.

v1.0.0

What

Get the geo location data of all the IP addresses passed as argument. This information includes:

Latitude and longitude
Time zone
Accuracy radius
Postal code
City name
Region
Country
Country of the service provider
Continent
Reverse PTR hostnames

Parameters

A list of public IPv4 or IPv6 addresses is required in the body of the request.

Result

The result contains a list of the result for each IP address, with the following data set:

The result is a JSON object with the following structure:

self: the URI of the API call
accuracy_radius: The radius in kilometers around the specified location where the IP address is likely to be.
asn_country_iso_code: The ISO code of the country of the Autonomous System (AS) owner of the IP address.
city_geoname_code:``: City geoname code. The geoname code by is a unique identifier assigned to each geographical point on the globe.
city_name:``: City name, in english. The developer can use the geoname code to localize the name of the city.
continent_code: The continent code. It can be any of the following: AF, AN, AS, EU, NA, OC, SA.
country_iso_code: The country ISO 3166-1 alpha-2 code.
hostnames: The list of hostnames associated with the IP address obtained from the reverse DNS lookup.
latitude: The latitude of the geolocation.
longitude: The longitude of the geolocation.
postal_code:``: The postal code of the city.
region_geoname_code:``: The geoname code of the region.
region_name:``: The region name, in english. The developer can use the geoname code to localize the name of the region.
time_zone: The name of the time zone.

Errors

The endpoint will return the following errors:

a 422 Unprocessable Entity error if the IP address is malformed.

The private IP addresses will be ignored, if any.

It will also return the API Global errors described in the API description.

Input

{
  "type": "array",
  "items": {
    "type": "string",
    "format": "ipvanyaddress"
  }
}

Output

{
  "type": "object",
  "required": [
    "results",
    "self"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "hostnames",
          "latitude",
          "longitude",
          "time_zone",
          "accuracy_radius",
          "postal_code",
          "city_name",
          "city_geoname_code",
          "region_name",
          "region_geoname_code",
          "country_iso_code",
          "asn_country_iso_code",
          "continent_code"
        ],
        "properties": {
          "accuracy_radius": {
            "type": "number"
          },
          "asn_country_iso_code": {
            "type": "string"
          },
          "city_geoname_code": {
            "type": "integer"
          },
          "city_name": {
            "type": "string"
          },
          "continent_code": {
            "type": "string"
          },
          "country_iso_code": {
            "type": "string"
          },
          "hostnames": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "latitude": {
            "type": "number"
          },
          "longitude": {
            "type": "number"
          },
          "postal_code": {
            "type": "string"
          },
          "region_geoname_code": {
            "type": "integer"
          },
          "region_name": {
            "type": "string"
          },
          "self": {
            "type": "string"
          },
          "time_zone": {
            "type": "string"
          }
        }
      }
    },
    "self": {
      "type": "string"
    }
  }
}