Every successful API request counts as one lookup. Requests refused with an error, such as an invalid API key or IP address, or a request over your limit, are not counted.
What happens when I reach my limit?
Paid plans keep working up to 110% of the monthly limit (a 10% buffer). After that, and at 100% on the Free plan, the API returns HTTP 429 until the limit resets at 00:00 UTC on the 1st of the month. You get email alerts as you get close, and you can upgrade at any time from the dashboard.
Can I use one key on several sites or servers?
Yes. A key isn’t tied to one site or server, and every lookup counts against that key’s monthly limit. Keep the key on your server and never put it in code that runs in the browser.
Can I upgrade or cancel at any time?
Yes. You can upgrade from the dashboard at any time. Subscriptions renew automatically until you cancel; when you cancel, the plan keeps working until the end of the period you have paid for.
How does billing work?
Plans are paid by card through Stripe. Each paid plan is a subscription for one API key, and each key has its own monthly limit. Billing yearly saves about 20%.
Does the Free plan need a card?
Yes. The Free plan needs a card on file when you sign up, but the card is never charged. Prepaid cards can’t be used for the Free plan, and each card can unlock the Free plan for one account. You get one free API key per account.
Can I cache results to save lookups?
Yes, and we recommend it. Network results rarely change, but Tor exits change every hour: if you block Tor, cache for about an hour, and never longer than a day.
Is HTTPS included?
Yes. Every plan, including Free, uses HTTPS (SSL).
For the API reference please check the documentation.
Access to our raw data is also available, contact us for more information.