Overview
Command Line Interface
API Documentation
FAQs
Your question has likely been answered before. Find answers here!
Where can I see my usage?
You can get your usage over the last 24hrs from the
count field returned in all API responses. To get your usage over a period greater than 24hrs you can submit a request to [email protected]. We are actively developing a dashboard to make this data more accessible and account management better.When does my quota renew?
All quotas renew at 12:00 AM UTC.
How long does the free tier last?
You can make up to 1500 requests daily with your free API key. Note that commercial use is restricted on the free tier, also the data provided on the free tier will be pared down in future. We do not have any plans to limit the length of the free tier at the moment.
What happens when I run out of requests?
On the free tier all further requests are blocked and you receive an email notification. On paid plans you receive a limit warning when you have used 90% of your quota. We also pad your account by 10% of your plan.
An edge case exists where you might not receive a limit warning email if you upgrade a free key after getting a limit warning and go on to exhaust your new upgraded quota in a short space of time after that.
How often is the data updated?
We make checks for changes in IP Address allocations daily and aggregate changes bi-weekly. Our threat data is updated every 15mins and aggregated hourly, that is the data changes every 15 minutes and we aggregate and publish those changes hourly.
I've received a notification that I've exhausted my quota and it's not possible
This can be particularly frustrating especially when your Google Analytics data doesn't match your usage. We can help you trace the origin of the traffic from our end. The reasons for this include;
- Calling the API on every page view. We recommend calling the API once per user session and storing the response in a cookie.
- Internal usage, you might have set your organisation's internal network to be excluded from Google Analytics and builds or automatic test suites running from that range are generating excessive requests
- Bots and scrapers
Some Solutions for this;
- Reaching out to us to help you trace the source of your traffic (paid users)
- Identifying bots from the user agent and not calling the API when it's a bot
- Caching user location per session to avoid excessive calls to the API
- Restricting use of your API Key to a whitelist of server IP Addresses or specific domains. This is the most secure way to access the API (paid users)
Are you GDPR compliant?
Yes. We act as data processors for the IP Address data you send us. Also note that we do not keep records of the IP Addresses you look up. We do however keep track of IP Addresses that make calls to our API for rate limiting purposes and then only for 24hrs. We may keep IP Addresses for longer if we have banned them. To get a copy of our DPA, send a request to [email protected].
Can I use my API Key on multiple domains?
Yes you can.
How do I upgrade and keep the same key?
If you are on the free tier, just sign up for any paid plan at https://ipdata.co/pricing.html with the same email address you used when you signed up for your free key and we will automatically upgrade your free key to a paid key.
On paid plans simply send a request to [email protected] and we will upgrade you from our end with no further action by you. Be sure to send the request from the email address you signed up with.
Can you handle my high-volume use case?
ipdata was built for high scalability, we run out of 11 AWS Data centers globally from Virginia to London to Sydney and can scale to billions of calls a day. You can learn more about our infrastructure from our feature on the AWS Startups Blog.
How do I submit a data correction?
Do bulk requests count as a single request?
If you make 10 bulk requests each with the maximum 100 IPs, then your quota will decrease by 1000. That is, 10 batches * 100 ips each =1000 credits).
The new features from Apple will prevent the exposure of an Apple user's exact IP Address but per this article Private Relay should use an IP address in the same city/region as the user's device so IP geolocation will still be accurate.
Last modified 10d ago
Copy link
Contents
Where can I see my usage?
When does my quota renew?
How long does the free tier last?
What happens when I run out of requests?
How often is the data updated?
I've received a notification that I've exhausted my quota and it's not possible
Are you GDPR compliant?
Can I use my API Key on multiple domains?
How do I upgrade and keep the same key?
Can you handle my high-volume use case?
How do I submit a data correction?
Do bulk requests count as a single request?
How will Apple's new privacy changes such as Private Relay impact geolocation accuracy?