General questions


What does ip-api do?

We provide a simple to integrate Geolocation API that provides information about your users (from their IP address), either directly from a browser or device, or from your servers.


When was ip-api established?

We launched ip-api in 2012 and our pro plan in 2014. Our office is located in Bucharest, Romania, and we're part of Artia Soft.


How can I contact you?

You can contact us by email at contact@ip-api.com or via this form. We usually reply within 1 hour.


Data


Where do you get the data?

We use multiple sources for populating our database, including BGP, RIR, ISP and data sharing agreements, geofeeds and latency-based tracking.
For some IP ranges we fallback to GeoLite2 data created by MaxMind, available from www.maxmind.com


How accurate is your data?

We try to return the most accurate location, however, IP Geolocation is not as accurate as GPS. Errors can happen, and depending on your use case, our data may not be sufficiently accurate. At our last survey, in February 2020, our measured accuracy was:

  • For Europe, our location data was 89% accurate on a city level, and 99% accurate on the country level
  • For USA, our location data was 88% accurate on a city level, 95% accurate on a state level, and 99% accurate on the country level
  • Globally, our location data was 83% accurate on a city level, and 99% accurate on the country level

How often do you update your database?

We are constantly parsing new data and pushing the changes to our endpoint. Most data is refreshed within 24 hours of a detected change.


Do you provide a downloadable database?

We do not currently provide a downloadable database, however, you're allowed to cache the API results.


How do I request a data correction?

For small changes, please use this form. For geofeeds and bulk corrections please email us.


API


What's the request limit?

We allow unlimited requests, but make sure to read our Acceptable Use Policy.


Is your API reliable?

We use a combination of Anycast and GeoDNS, using dedicated servers from multiple providers, to achieve over 99.999% of monthly API uptime, incredible performance, redundancy, scalability and capacity.
Our endpoints are continuously monitored from over 80 PoPs, and we quickly bypass congested or faulty networks. A human is always on-call and ready to take care of any potential issues.
Check out our global latency and uptime here.


What SLA do you offer?

We are committed to a service level of 99.9% API monthly uptime, with a response time (TTFB) of under 500ms in most parts of the world and under 100ms in US, Europe and most of Asia. If the general API uptime falls below 99.9% in a month, we will automatically extend your subscription for 10 days.
Please read our Terms of Service for SLA details.


Do you offer usage statistics?

The dashboard offers usage statistics (demo) for each of your API keys, including 3 charts:

  • Statistics for the past 6 hours, with 1 minute resolution, updated every minute
  • Statistics for the past 7 days, with 1 hour resolution, updated every hour
  • Top 25 countries queried, by day, for up to 7 days, updated every minute

You can also see the total number of requests per month.


What are these failed requests from the charts?

Failed requests are shown on the charts as:

  • restricted request was denied due to the API key restrictions
  • invalid an invalid IP address or domain name was supplied
  • bogon a private or reserved IP address was supplied

What error message can be returned for a failed request?
  • private range
  • reserved range
  • invalid query
  • Origin restriction, modify at https://members.ip-api.com/keys
  • IP range restriction, modify at https://members.ip-api.com/keys
  • Calling IP restriction, modify at https://members.ip-api.com/keys
  • invalid/expired key, renew at https://members.ip-api.com/order
  • no API key supplied, order one at https://signup.ip-api.com/

How do you authenticate requests?

All requests need an API key for authentication, supplied as a GET parameter. You can create up to 10 different API keys.


Can I set access restrictions?

You can set up to 20 restrictions (demo) for each of your API keys, and we currently support IP address and Origin (CORS) rules.


How do I download request logs?

We do not currently provide a way to download API logs. Please contact us if you need access to recent (up to 24 hours) request logs.


Billing


What form of payments do you accept?

We accept VISA, Mastercard, PayPal, Alipay, Bitcoin and Ethereum. For paying by bank transfer please contact us.


How can I cancel my subscription?

You can stop renewing your subscription and it will automatically expire. We do not bill automatically, the service is prepaid.


Do you offer automatic renewals and payments?

We do not currently support automatic renewals, and your subscription has to be manually renewed. Please contact us if you want to pay at a later date (overdue payments).