Overview
GeoJS is a free, no-auth-required IP geolocation API that returns the approximate location of any IP address, including country, city, latitude, and longitude. It also supports ChatOps integrations for use in Slack or similar tools. Because it requires no API key, you can start using it immediately in any project.
Beginner Tip
Calling the /v1/ip/geo.json endpoint without specifying an IP address automatically geolocates the caller, which is perfect for detecting a visitor country on a website.
Measurement Record
What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.
- Request
- GET https://get.geojs.io/v1/ip/geo.json
- Result
- HTTP 200 · application/json · 328 bytes · compressed
- Response time
- 42 ms (median of 3) · fastest 36 ms
- Transport
- TLSv1.3 · TLS_AES_256_GCM_SHA384 · certificate issued by Google Trust Services
- Browser CORS
- Allowed — Access-Control-Allow-Origin: *
- Served by
- cloudflare
- Recorded
- 2026-08-10
Fields Returned
Top-level fields present in the response we captured, with the type and value we actually received.
| Field | Type | Value received |
|---|---|---|
| accuracy | integer | 50 |
| area_code | string | 0 |
| asn | integer | 9824 |
| city | string | Chūō |
| continent_code | string | AS |
| country | string | Japan |
| country_code | string | JP |
| country_code3 | string | JPN |
| ip | string | 119.170.249.193 |
| latitude | string | 33.8692 |
| longitude | string | 130.8445 |
| organization | string | AS9824 JCOM Co., Ltd. |
| organization_name | string | JCOM Co., Ltd. |
| region | string | Fukuoka |
Captured Response
Captured from a real request to https://get.geojs.io/v1/ip/geo.json on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.
{
"accuracy": 50,
"area_code": "0",
"asn": 9824,
"city": "Chūō",
"continent_code": "AS",
"country": "Japan",
"country_code": "JP",
"country_code3": "JPN",
"ip": "119.170.249.193",
"latitude": "33.8692",
"longitude": "130.8445",
"organization": "AS9824 JCOM Co., Ltd.",
"organization_name": "JCOM Co., Ltd.",
"region": "Fukuoka",
"…": "(1 more fields)"
} Field Reference
ip The IP address that was geolocated. country Full country name associated with the IP address. country_code ISO 3166-1 alpha-2 two-letter country code. city Approximate city name for the IP address. latitude Approximate latitude of the IP address location. longitude Approximate longitude of the IP address location. Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://get.geojs.io/v1/ip/geo.json";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
How This API Fails
We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.
Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Measured Score Breakdown
Live HTTP request to the API endpoint
Fully tested on Aug 10, 2026
Technical Specifications
Related Tags
Similar APIs
View All →administrative-divisons-db
⭐ Beginner's PickThe Administrative Divisions DB API provides a structured list of all administrative divisions (states, provinces, regions, cities) for countries around the world.
adresse.data.gouv.fr
adresse.data.gouv.fr provides programmatic access to address database of france, geocoding and reverse via REST API.
Airtel IP
⭐ Beginner's PickAirtel IP is a free, no-auth IP geolocation API that aggregates data from multiple sources to return the country associated with any given IP address.
bng2latlong
⭐ Beginner's Pickbng2latlong is a simple, free API that converts British National Grid (OSGB36) easting and northing coordinates into standard WGS84 latitude and longitude.
Cartes.io
⭐ Beginner's PickCartes.io is a free API that lets you create maps and add custom markers without signing up.