API docs

Making requests

GEThttps://geoipify.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&ipAddress=8.8.8.8

It takes up to 2 minutes to activate your account after Sign Up.

Input parameters

apiKey
Required. Get your personal API KEY on My products page.
ipAddress
Optional. IPv4 or IPv6 to search location by.

If the parameter is not specified, then it defaults to client request's public IP address.
domain
Optional. Domain name to search location by.

If the parameter is not specified, then 'ipAddress' will be used.
email
Optional. Email address or domain name to search location by it's MX servers.

If the parameter is not specified, then 'domain' will be used.
outputFormat
Optional. Response output format.

Acceptable values: JSON | XML

Default: JSON

Free access

After Sign Up you automatically get a free subscription plan limited to 1000 requests per month.

Sample output

JSON
XML
                            {
  "ip":"8.8.8.8",
  "location": {
    "country": "US",
    "region": "California",
    "city": "Mountain View",
    "lat": "37.40599",
    "lng": "-122.078514",
    "postalCode": "94043",
    "timezone": "-08:00"
  }
}

                        
                            <xml>
<ip>8.8.8.8</ip>
<location>
  <country>US</country>
  <region>California</region>
  <city>Mountain View</city>
  <lat>37.40599</lat>
  <lng>-122.078514</lng>
  <postalCode>94043</postalCode>
  <timezone>-08:00</timezone>
</location>
</xml>
                        
ip
Requested (for search by 'ipAddress') or resolved (for search by 'domain' or 'email') IP address.
location.country
Two letters country code from ISO 3166.
location.region
Region
location.city
City
location.lat
Latitude
location.lng
Longitude
location.postalCode
Postal Code
location.timezone
Timezone

Try IP Geolocation API for free

Have questions?
support@whoisxmlapi.com
We will get back to you within a day.
WHOIS API, Inc.

California
USA

Contact us