Plans and limits
| Plan | Price | Included | Fields |
|---|---|---|---|
| Free | $0 | 20,000 / mo | country, countryName, continent |
| Starter | $9 / mo | 250,000 | all |
| Growth | $29 / mo | 1,500,000 | all |
| Scale | $99 / mo | 10,000,000 | all |
The free tier is country-level only. City, region, timezone, coordinates,
postal code, ASN and the derived currency and language fields all need a paid
plan. If you are coming from the old js.instantgeo.info endpoint, note that it
returned city and coordinates to everyone — see
migrating from v1.
Your bill is your plan price
Every plan stops at its included requests. When you reach the limit, further requests return 429 until the period resets. There is no overage, no usage charge, and no way for a busy month to produce a bill you did not choose.
That is a deliberate trade. A traffic spike costs you requests, not money — and if you need more, you upgrade rather than discover it on an invoice.
Alerts
We email you at 80% and at 100% of your included requests, once each per billing period.
Plan changes
Upgrades apply immediately — if you are at your limit, you are unblocked as soon as PayPal confirms. Downgrades apply at the end of the period, so you keep what you paid for.
Subscriptions are billed monthly through PayPal. Cancel any time from Billing; your keys keep working on the free plan.
Rate limits
Separate from your monthly quota:
| Caller | Limit |
|---|---|
| No key | 60 / hour / IP |
Publishable key, no Origin header | 1,000 / hour / IP |
Publishable key with a valid Origin | monthly quota only |
| Secret key | 1,000 / hour / IP |
Browsers always send Origin on cross-origin requests, so normal browser traffic
is governed only by your monthly quota.