The same IP lookup that powers this site is available as a JSON API. Use it to enrich sign-ups, flag network type, localise content or log where requests come from.
Plans
Anonymous
Free
5 requests per day
Trying the response format
- No key needed
- Looks up your own IP only
- Same JSON as the paid tiers
No signup needed.
Free key
Free
1,000 requests per month
Side projects, prototypes, scripts
- Look up any public IPv4 or IPv6 address
- Quota and reset headers on every response
- Email request, no card
Pro
Contact us
50,000 requests per month
Production apps with moderate traffic
- Everything in Free key
- 50x the monthly quota
- Email support
Business
Contact us
500,000 requests per month
High-volume enrichment and fraud signals
- Everything in Pro
- 500x the free monthly quota
- Higher limits on request
Quotas are enforced by the server. Prices that show "Contact us" are agreed by email until self-service billing is available.
Common uses
- Sign-up and checkout review: compare the country of an address with the billing country and note when traffic comes from a hosting network.
- Content localisation: choose a language or currency from an approximate country.
- Analytics enrichment: attach network and country to requests without storing raw addresses.
- Support tooling: show a user which address and provider they appear to come from.
What a response contains
Each response includes the address, approximate country, region and city, the network owner and ASN, a network-type indication and privacy-score metadata with its method. VPN or hosting detection is an inference from the network name and includes a vpnConfidence and vpnBasis; it should be treated as a signal, not proof. See the API documentation for every field.
Which plan fits
- Trying it out or a hobby project: start anonymously, then ask for a free key once you need more than a few lookups a day.
- A small product or internal tool: the free key or Pro plan covers most sign-up checks and dashboards. Cache results to stay well inside the quota.
- High volume or special needs: tell us your volume in the form below. Business-size usage, a service agreement or a custom limit is agreed by email.
How quotas work
Quotas are counted per key each month. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers, so your code can slow down before it hits 429. Full request and error details are in the API documentation.
Compared with building it yourself
A lookup API saves you from licensing and updating location and network data. It does not make the data exact: IP location is approximate and VPN detection is an inference. If your decision depends on precision, use the result as one signal alongside others, as described on the methodology page.
Honest limits
- Geolocation is an estimate. Country is usually right; city often is not, especially on mobile networks.
- We do not provide guarantees about fraud or identity. Use results as one signal among several.
- We do not log the addresses you look up beyond what is needed to enforce your quota. See the privacy policy.
Request an API key
Tell us what you are building and roughly how many lookups you expect. We reply by email, usually with a free key to try. Paid plans and self-serve billing will follow once there is enough demand.
The request form is not available right now. Email hello@scanmyprivacy.com with your use case and expected volume.
How to start
- Try the anonymous allowance with
curl https://scanmyprivacy.com/api/v1/lookup. - Fill in the request form above with your use case and expected volume.
- Send the key in the
x-api-keyheader.