Skip to content
IP Address Today

IP Geolocation API

Location, ISP, ASN and timezone for any IPv4 or IPv6 address, as JSON. Free to start, with no key and no sign-up.

  • 45 requests a minute with no key
  • 10,000 a month free with a key
  • No overage charges, ever
GET/api/v1/ipCalling the API…

What you get back

One request returns everything below. Every field in the docs is a field the API actually sends.

Location

location.country
Name, ISO codes, capital, calling code, currency, flag
location.region · city · postalCode
Subdivision, city and postcode where known
location.latitude · longitude
Approximate centre point
location.accuracyRadius
How far off it could be, in km

Network

connection.asn · as
Autonomous System number
connection.isp · org
Provider and organisation
connection.network
The CIDR block the IP belongs to
hostname
Reverse DNS name

Privacy flags

privacy.tor
Tor exit node
privacy.hosting
Datacenter or hosting address
ipInfo.isPublic · isPrivate · isReserved
Address classification

Time and locale

location.timezone
IANA zone, abbreviation, UTC offset, local time
location.continent
Continent
meta.databaseVersion
Which data build answered

Works in any language

It’s a plain HTTPS GET that returns JSON. No SDK needed. Send your key in the X-API-Key header, or leave it out for keyless requests.

Full quickstart
curl -H "X-API-Key: YOUR_KEY" \
  https://api.ipaddresstoday.com/api/v1/8.8.8.8

What people build with it

  • Fraud and risk checks

    Flag sign-ups or payments where the IP country doesn’t match the billing country, or that come from Tor or a datacenter.

    location.country.code · privacy.*
  • Localise automatically

    Pre-select country, currency, language and timezone on forms and checkouts.

    country.currency · timezone.id
  • Analytics enrichment

    Add country, region and network to your own event data without a client-side tracker.

    location.* · connection.isp
  • Regional rules

    Show region-specific content, pricing or notices where you’re required to.

    location.country.code
  • Security logs

    Enrich sign-in and audit logs with location and ASN to spot unusual access.

    connection.as · location.city
  • Network tooling

    Group traffic by ASN or network block for rate limiting and abuse handling.

    connection.network · connection.asn

IP location is approximate. Use it to personalise and flag, not to identify people or make decisions about them on its own (see the Acceptable Use Policy).

Simple pricing, no surprises

Compare all plan features
  • Free$045/min keyless · 10K/month keyed2 keys · commercial use
  • Starter$5 /mo150K requests/monthBatch lookups · email support
  • Pro$19 /mo1M requests/monthPriority support · most popular
  • Business$69 /mo10M requests/monthUnlimited keys · dedicated support

Go over your quota and you get an HTTP 429 until it resets. You are never billed for overage. Prices in USD; GST added for Australian customers.

How it compares

Competitor details from their public pricing and docs pages (IPinfo, ipstack, ipgeolocation.io), checked 31 October 2026. USD, monthly billing. ipgeolocation.io counts credits; a basic lookup is 1 credit. Prices change, so check before relying on them.
FeatureIP Address TodayIPinfoipstackipgeolocation.io
Free requests without a key45 per minuteNot advertisedNot advertisedNot advertised
Free plan10,000/month, full data, commercial useUnlimited, country + ASN only100/month, location only, no commercial use1,000 credits/day, for testing
Cheapest paid planUS$5 for 150KUS$26 for 150K (Core)US$12.99 for 50KUS$19 for 150K credits
Around 1M a monthUS$19 for 1M (Pro)Core tiers up to 5M, priced on their siteUS$99.99 for 2M (Professional+)US$79 for 1M credits (Pro)
Going over quotaNever billed, 429 insteadBilled (Core US$0.34 per 1K)Overage fees applyOptional overage, else 429
Batch lookups100 per request (Starter+)Batch APIProfessional+ onlyPaid plans, up to 50,000
IPv6YesYesYesYes

Private by design

We don’t store the IP addresses you look up or send them to anyone. Lookups run on our own servers in Australia.

Privacy Policy

Secure keys

Keys are hashed, can be scoped, set to expire and locked to your server IPs. Two-factor sign-in for your account.

Security

Errors you can act on

Errors follow RFC 7807 problem+json, and every error type has a documented cause and fix.

Error reference

Developer FAQ

Do I need an API key?

No. You can make 45 requests a minute without one. A free key gives you 10,000 lookups a month, usage stats and key controls.

How accurate is IP geolocation?

Country is right more than 99% of the time. City accuracy varies from a few kilometres in cities to hundreds in rural areas. Every response includes accuracyRadius so you know how precise it is.

What happens when I hit my limit?

Requests return HTTP 429 until your quota resets. Rate-limit headers tell you how many requests are left and when the window resets. You are never charged for overage.

Does it support IPv6?

Yes. IPv4 and IPv6 addresses return the same response format.

Can I use it commercially?

Yes, on every plan, including Free. Paid plans add higher quotas, batch lookups and email support.

Can I cache results?

Yes, and we recommend it. Cache what your application requested; just don’t resell or redistribute the data as a database.

How fresh is the data?

We check for new MaxMind GeoLite2 builds every 24 hours. Each response includes meta.databaseVersion.

Is it GDPR-friendly?

We don’t store the addresses you look up. If you send us your users’ IPs, you remain responsible for having a lawful basis, as with any processor you use.

Start in under a minute

Call it right now with no key, or sign up for 10,000 free lookups a month.

curl https://api.ipaddresstoday.com/api/v1/ip