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": "110.170.64.0",
  "location": {
    "country": "TH",
    "region": "Bangkok",
    "city": "Bangkok",
    "lat": 13.7083,
    "lng": 100.4562,
    "postalCode": "10120",
    "timezone": "+07:00"
  },
  "isp": "True Internet",
  "domains": [
    "110-170-64-0.static.asianet.co.th"
  ],
  "as": {
    "asn": 7470,
    "name": "TRUE INTERNET Co.,Ltd.",
    "route": "110.170.64.0/18",
    "domain": "trueinternet.co.th",
    "type": "Cable/DSL/ISP"
  }
}

                        
                            <xml>
<ip>110.170.64.0</ip>
<location>
  <country>TH</country>
  <region>Bangkok</region>
  <city>Bangkok</city>
  <lat>13.7083</lat>
  <lng>100.4562</lng>
  <postalCode>10120</postalCode>
  <timezone>+07:00</timezone>
</location>
<isp>True Internet</isp>
<domains>
  <domain>110-170-64-0.static.asianet.co.th</domain>
</domains>
<as>
  <asn>7470</asn>
  <name>TRUE INTERNET Co.,Ltd.</name>
  <route>110.170.64.0/18</route>
  <domain>trueinternet.co.th</domain>
  <type>Cable/DSL/ISP</type>
</as>
</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 in the format "+10:00"
isp
Internet Service Provider
domains
Array of domains associated with the IP. The field is omitted if the record is not found. This array is limited to 5 domains. If you want to get more check out Reverse IP API.
as {}
Autonomous System. It works for IPv4 only. The field is omitted if the record is not found.
as.asn
Autonomous System Number
as.name
Autonomous System Name
as.route
Autonomous System Route
as.domain
Autonomous System Website's URL
as.type
Autonomous System type, one of the following: "Cable/DSL/ISP", "Content", "Educational/Research", "Enterprise", "Non-Profit", "Not Disclosed", "NSP", "Route Server". Empty when unknown.

Account balance information

GEThttps://user.whoisxmlapi.com/service/account-balance?apiKey=YOUR_API_KEY
apiKey
Required. Get your personal API KEY on My products page.
productId
Optional. A list of the products' IDs can be found in the response.

- You can always check your account balance on the My products page. - Note that the following products use the same WHOIS credits: WHOIS API, Bulk WHOIS API, Domain Availability API. - Note that the following products use the same Domain Research Suite credits: Brand Alert API, Registrant Alert API, Reverse WHOIS API, WHOIS History API, Reverse IP/DNS API, Reverse MX API, Reverse NS API.
Try our IP Geolocation API for free
Get started
Have questions?
support@whoisxmlapi.com
We will get back to you within a day.
WHOIS API, Inc.

California
USA

Contact us