Where your visitor is, in one request.
One GET returns the country your visitor is browsing from. No SDK, no build step, no account needed to try it.
Response
- country
- "PK"
- countryName
- "Pakistan"
- continent
- "AS"
A live request from your browser, unauthenticated.
The whole API
fetch('https://api.instantgeo.info/v1/geo?key=ig_pk_yourkey')
.then(r => r.json()) Currency and language defaults, shipping estimates, store locators, regional content, tax display, compliance banners.
It answers where the caller is, not where an arbitrary IP is. There is no
?ip= parameter.
Pricing
Every account stops at its included requests unless you turn overage on. If you do, you set a spend cap in dollars and we stop serving before you cross it. Overage is billed per request, not per block.
Your key is public, and that is fine
A publishable key sits in your page source where anyone can read it. What protects it is the origin allowlist: the sites permitted to use that key. For servers and mobile apps there is a separate secret key, shown once.
ig_pk_3lSd2qIjtv9lw8GI ig_sk_•••••••••••••••• The two are different shapes, not different colours — so the difference survives a screenshot, a greyscale print, and colourblindness.
We store the country, not the IP. Your visitors' addresses appear in the response and nowhere else.
What we run on
One server, behind Cloudflare. We do not advertise a 99.9% SLA because we cannot back one yet. Availability is best effort until that changes, and we would rather say so now than publish a number we would have to walk back.