Get the geolocation data of the IP addresses set.
POST {{baseUrl}}/v1/geo
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 [GeoNames](https://en.wikipedia.org/wiki/GeoNames) is a unique identifier assigned to each geographical point on the globe.
-cityname:: City name, in english. The developer can use the geoname code to localize the name of the city.
- ``continentcode: The continent code. It can be any of the following: AF, AN, AS, EU, NA, OC, SA.
-countryisocode: 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.
-postalcode:: The postal code of the city.
- ``regiongeonamecode:: The geoname code of the region.
- ``regionname:: 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.
Request Body
["aliqua Excepteur ci"]
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"self":"incididunt quis minim culpa","results":[{"hostnames":["dolore tempor et anim","deserunt consectetur"],"latitude":9524512.364009976,"longitude":-54750509.65247563,"time_zone":"consequat pariatur Lorem","accuracy_radius":47594035.07370821,"postal_code":"e","city_name":"pariatur exercitation","city_geoname_code":86498386,"region_name":"Excepteur magna aute Lorem","region_geoname_code":-3819701,"country_iso_code":"nulla qui incididunt","asn_country_iso_code":"est quis ea elit","continent_code":"culpa","self":"enim ullamco veniam nostrud magna"},{"hostnames":["conse","in nisi Duis mollit"],"latitude":69434083.88408795,"longitude":61955910.013453245,"time_zone":"anim laboris ad","accuracy_radius":52377170.643972576,"postal_code":"deserunt ipsum","city_name":"Ut","city_geoname_code":-51281986,"region_name":"non","region_geoname_code":-87488702,"country_iso_code":"culpa aute ad","asn_country_iso_code":"non ea dolore","continent_code":"magna adipisicing minim","self":"magna"}]}