01GET /api/lookup/{ip}
Single lookup
Resolve any IPv4 or IPv6 address, or the caller's own, in one GET. Country, region, city, postal code, coordinates, timezone and network operator come back together — no second call, no redirect chain.
IP geolocation · Network intelligence
We already know
where you are
reading this from.
No form, no consent prompt, no browser permission — just the address your request arrived on. Everything in that readout is your own connection, resolved by the same API your product would call.
- IPv4 + IPv6
- Address families
- 100
- Addresses per batch
- 12
- Fields per response
Your connection
Address
Country
Region
City
Postal
Timezone
Network
Operator
The response
Twelve fields.
One round trip.
Nullable means the dataset had no entry, not that the request failed. A partial answer is returned rather than an error, because knowing the country and the network is usually enough to act on.
FieldTypeMeaning
ipstringThe address as resolved, normalised to its canonical form.ipDecimalnumber | null32-bit integer form. Null for IPv6, where it would overflow.countrystring | nullCountry name in English.countryCodestring | nullISO 3166-1 alpha-2.regionstring | nullFirst-level subdivision — state, province, oblast.citystring | nullCity name, where the dataset resolves to one.postalstring | nullPostal or ZIP code.latitudenumber | nullDecimal degrees. Centroid, not a street address.longitudenumber | nullDecimal degrees.timezonestring | nullIANA zone, e.g. Europe/Belgrade.asnnumber | nullAutonomous system number of the announcing network.asnOrgstring | nullOrganisation operating that network.Quickstart
One header.
That's the integration.
Authentication is a single X-Api-Key header. No SDK to install, no OAuth dance, no token refresh. Every response tells you how much of your monthly allowance is left.
- Keys are shown once at creation and stored only as a hash.
- Revoke any key instantly; the next request with it fails closed.
- Batch calls are billed as N and charged all-or-nothing.
curl https://iplocus-backend.onrender.com/api/lookup/8.8.8.8 \ -H "X-Api-Key: li_live_your_key_here"
Capabilities
Built for the request that has to answer now.
02POST /api/lookup/batch
Batch resolution
Post up to 100 addresses in a single request and get an ordered array back. Malformed entries are returned in place rather than failing the batch, so one bad row never costs you the other ninety-nine.
03asn · asnOrg
Network intelligence
Every response carries the autonomous system number and the organisation behind it. That is what separates a residential subscriber from a datacentre, a VPN exit or a corporate range.
04X-Quota-Remaining
Keys and quota
Issue as many keys as you have environments, revoke any of them instantly, and read your consumption against the monthly allowance at any time. Every response reports what is left.
Plans
Priced on volume.
Accounts are provisioned by our team, on the tier that matches your traffic. Tell us roughly what you expect and we will size it with you — moving up a tier later takes a message, not a migration.
Starter
50,000
lookups / month
A single product, one environment, predictable traffic.
Contact salesPro
500,000
lookups / month
Production traffic across several services, with batch resolution.
Contact salesBusiness
5,000,000
lookups / month
High-volume scoring, enrichment pipelines and analytics workloads.
Contact salesCustom
Beyond 5M
talk to us
Dedicated capacity, custom terms, and a direct line to the engineers.
Contact salesEvaluating? The demo above runs on the same API, unauthenticated and rate limited per address — no key required. Talk to us when you need it in production.
Contact sales
Tell us what you're
resolving.
We will come back with a key, a quota sized to your volume, and a straight answer about whether this dataset fits your case. If it does not, we will say so.