Making requests

GET https://ip-geolocation.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&ipAddress=8.8.8.8
It takes up to a minute to activate your account after the registration.

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 1,000 requests per month.

Have questions?

We work hard to improve our services for you. As part of that, we welcome your feedback, questions and suggestions. Please let us know your thoughts and feelings, and any way in which you think we can improve our product.

For a quick response, please select the request type that best suits your needs. For more info regarding the request types, see the Contact us page.

By submitting, you agree to the Terms of Service and Privacy Policy.

Or shoot us an email to