API docs | IP Geolocation API

API docs

Making requests

GET https://geo.ipify.org/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 subscriptions page.
ipAddress Optional. IP address to search location by.

If the parameter is not specified, then it defaults to client request's public IP address.

Free access

After Sign Up you automatically get a free subscription plan limited to 1,000 queries per month.

Output format

{
  "ip":"8.8.8.8",
  "location": {
    "country": "US",
    "region": "California",
    "city": "Mountain View",
    "lat": "37.40599",
    "lng": "-122.078514",
    "postalCode": "94043",
    "timezone": "-08:00"
  }
}
ip Requested 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 out IP Geolocation API free of charge
Get started
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.

Or shoot us an email to