Free Geolocation API

Get (mostly) accurate geolocation data of any IP address.

Overview API Reference

API Reference

This API provides geolocation data for a given IP address or a list of IP addresses (soon).

GET

https://api.geo4ip.com/v1/lookup?ip=

3.149.29.230

Response

{
  "ip": "<ip_address>",
  "asn": {
    "number": "<number>",
    "organization": "<string>"
  },
  "geo": {
    "latitude": "<number>",
    "longitude": "<number>",
    "time_zone": "<string>"
  },
  "city": {
    "geo_id": "<number>",
    "name": "<string>",
    "province_code": "<string>",
    "province_name": "<string>",
    "region_code": "<number>",
    "region_name": "<string>"
  },
  "continent": {
    "geo_id": "<number>",
    "code": "<string>",
    "name": "<string>"
  },
  "country": {
    "geo_id": "<number>",
    "code": "<string>",
    "name": "<string>",
    "flag": "<string>",
    "is_eu": "<boolean>",
    "currencies": {
      "<string>": {
        "code": "<string>",
        "name": "<string>",
        "symbol": "<string>"
      }
    },
    "languages": {
      "<string>": {
        "code": "<string>",
        "name": "<string>"
      }
    }
  }
}

HTTP Responses

The API returns the following HTTP Status codes:

Geo4IP API HTTP Sttaus codes.
Code	Status
200	OK	Request completed successfully and the response contains data.
400	Bad Request	The request is invalid (forgot the ip address?).
401	Unauthorized (soon)	API key is absent or invalid.
404	Not Found	Request url / resource is not found.
500	Internal Server Error	There was a problem with the api.