Geo Lookup

Get geolocation data for an IP address

Endpoint

GET /geo?ip={ip}

Query parameters

ip

string

required

Possible values: an IPv4 or IPv6 address
The IP address for geo lookup. If omitted, the IP address from which the request is made will be used

Response body

A JSON object with geolocation data:

ip

string

required

Possible values: an IPv4 or IPv6 address
The IP address used for the lookup

country_code

string

required

The 2-letter code of the geolocated country in the ISO 3166-1 alpha-2 format, e.g., DE

tz

string

required

The timezone, e.g., Europe/Berlin

country

string

required

The name of the country, e.g., Germany

city

string

required

The geolocated city, e.g., Düsseldorf.

lat

float

required

Latitude

lng

float

required

Longitude

Example request

JS + Fetch

const query = new URLSearchParams({
    ip: "11.22.33.44",
});

const response = await fetch(`https://api.ateratti.com/geo?${query}`, {
    headers: { "X-Api-Key": "Your API key" },
});

const geo = await response.json();
console.log(geo);

Example response

200 OK

{
    "ip": "11.22.33.44",
    "country_code": "DE",
    "country": "Germany",
    "city": "Stuttgart",
    "tz": "Europe/Berlin",
    "lat": 48.767,
    "lon": 9.1827
}