ip-api.com

Free IP geolocation (non-commercial)

AUTH NONECORS AGENT ?HTTPS COMMERCIAL ?

Location and ISP metadata. Free without key on HTTP; HTTPS needs paid plan.

HOW IT'S SCORED ⓘ
Status badge · for your READMEshipapis health badge: — · unmonitored
ON PROBE SCHEDULE

We probe a documented GET and expect 2xx JSON — full uptime and health score. Open provider docs ↗

Uptime historystarts after first probe

On our probe schedule. Uptime charts appear after the first check lands.

Example responsefrom provider docs — not verified by us
GET http://ip-api.com/json/8.8.8.8?fields=status,country,city,lat,lon

{
  "status": "success",
  "country": "United States",
  "city": "Ashburn",
  "lat": 39.03,
  "lon": -77.5
}
Call itcurl · fetch · python
curl "http://ip-api.com/json/8.8.8.8?fields=status,country,city,lat,lon"
const res = await fetch("http://ip-api.com/json/8.8.8.8?fields=status,country,city,lat,lon");
const data = await res.json();
console.log(data);
import requests

res = requests.get("http://ip-api.com/json/8.8.8.8?fields=status,country,city,lat,lon")
print(res.json())

BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET

Endpoints · 6On scheduleFULL DOCS ↗
On schedule — GET /json/8.8.8.8?fields=status,country,city,lat,lon awaits first probe
GET/json/8.8.8.8?fields=status,country,city,lat,lonPROBED

Free IP geolocation (non-commercial)

GET/json

Json — documented GET route.

GET/json/1

Json details by ID (example: 1).

GET/json?limit=10

Json — documented GET route.

GET/json/search?q=test

Search by query parameters.

GET/json/8.8.8.8?limit=5

8 8 8 8 — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Not tracked yet. Shape-change history starts once this API joins our probe schedule.

ip-api.com: common questions

Is ip-api.com free to use?

Yes — ip-api.com is a free developer tools API. Free tier: Free — limits not published. Whether the free tier allows commercial use is unclear — check the provider docs.

Does ip-api.com need an API key?

No — ip-api.com needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).

Can I call ip-api.com from the browser?

Not directly — ip-api.com doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.

Is ip-api.com up right now?

ip-api.com is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.