Making requests | Documentation | IP Geolocation API | WhoisXML API

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.

reverseIp

Optional. If 1, then 5 domains associated with the IP address will be shown.

If you would like to get more domains, check out Reverse IP API.

Acceptable values: 0 | 1

Default: 1

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 queries.

Usage limits and requests throttling

The maximum number of requests per second is 100. In case that the limit is breached, your subsequent requests will be rejected until the next second.

This API is also available with a dedicated load balancer and premium endpoint to enable faster querying as part of our Premium API Services and Enterprise API Packages.