Frequently Asked Questions

API Access

How do I get an API Key?

Simply create an account and login to your Dashboard to view your API key.

There is no credit card or payment required to get an API key and to use any of the BigDataCloud APIs.

What is API Propagation?

When a new API key is created and allocated to you (when you create a new account or renew your api key) it can take up to 15 minutes for this key to be available for use world-wide.

This is similar to DNS propagation, where a change in address can be recognised across all international networks.

How do I reset my API Key?

If you wish to generate a new API key for any reason, simply login to BigDataCloud and access your Dashboard.

Underneath your API Key you are given the option to "Generate (a) New Api Key"... simply click on this and follow the prompts.

Please note, this will disable your existing key and will take up to 15 minutes for the changes to take effect.

API Technology

How often is the data updated?

The data supplied by BigDataCloud is refreshed continuously, offering industry leading update times across the entire range of APIs.
  • Geolocation data re-evaluated every 2 hours or at least once a day
  • BGP data updated every 2 hours
  • Registry data updated at least once a day
  • Country object data usually updates at least once in a month

How does BigDataCloud differ from other API services?

  1. Our APIs are highly optimised for speed, most of which are designed to respond within a few milliseconds. We have also implemented a globally distributed API server network ensuring that each API request is served by the closest geographically available server.
  2. Our data is updated much more frequently than other providers, allowing us to offer industry leading update times across the entire range of APIs.
  3. Our free service offers the same features and remarkable speed across all APIs, which ensures small businesses and developers have quality data for free and for life.
  4. Our pricing model is much more transparent, flexible and fair. We won’t force you to sign up for an inflated premium subscription you don’t even need.

How fast are the APIs?

BigDataCloud APIs are some of the fastest in the industry.

On average, most API requests are handled in less than a millisecond!

Are there limits on how many API requests I can do?

The only limitation on how many API requests you can make is based on your subscription.

There is no limitation on the number of concurrent requests, or requests per minute/hour so long as it fits within your subscription amount.

What formats is the API data available in?

Currently, the API offers all data in JSON format.

IP Geolocation Technology

My location is wrong, how do I fix it?

If for some reason our IP Geolocation result for your IP is not accurate, you can help us to improve by sharing your location.

View detailed instructions here

How accurate is the Geolocation API?

Our IP Geolocation technology is far superior to other service providers.

Quality IP Geolocation accuracy largely relies on collecting proven field evidence data which BigDataCloud retrieves directly from this website, our mobile apps and through our partners. Our current IP Geolocation accuracy is either better or on par with the higheset enterprise level IP Geolocation services. Unlike these other providers, our accuracy is continuously improved. This will soon make us the most accurate IP Geolocation service in the world.

Visit IP Geolocation Service Status for the up to date accuracy report.

Visit our blog article: Ip Geolocation Demystified for a detailed overview of the current state of IP Geolocation providers.

Do you use any other IP Geolocation service provider’s data?

No, we do not use nor rely on any other commercial IP Geolocation data.

What data sources you utilise for your IP Geolocation?

We do not use nor rely on DNS entries

Our IP Geolocation data is solely relies on:

  • WhoIs registry data
  • BGP global routing data
  • Field evidence data
  • Our proprietary, network infrastructure crawler’s Big Data


API Subscriptions

How do subscriptions work?

Each BigDataCloud Api offers a substanial number of free API queries per month.

If you require more than this free allocation, then you can make use of our subscriptions to increase this amount.

A subscription works by allowing you to specify your monthly usage requirement for the API's if you expect to go above the free threshold.

This usage is specified in lots, with a monthly fee allocated to the each lot you require.

Let us use the IP Address Geolocation with Confidence Area API as an example.

This API has a cost of USD$2.00 per 10,000 queries, per month.

If you require 100,000 queries per month then the subscription cost can be calculated as follows:

Total monthly queries required: 100,000
Less free queries (10,000): 90,000
Units required (divide by 10,000): 9
Price per unit: USD $2.00
Total monthly subscription: USD $18.00

If you prefer to pay yearly, you will also receive a 20% discount on your subscription.

We provide an extremely easy to use subscription tool to manage your subscription, click here to get started.

What payment methods does BigDataCloud support?

BigDataCloud currently supports all major credit cards as well as payment via PayPal.

Do I need a credit card to use the APIs?

No, there is no need for a credit card to access any of our APIs.

Each API offers a substantial number of free API requests per month.