Skip to content
GET /api/v1/ip-geolocation

IP Geolocation

Convert IP addresses to location data including country, city, coordinates, timezone, and ISP information

Parameters

name in type required description
ip query string required IPv4 or IPv6 address

Request

Send your key in the X-API-Key header. More languages and patterns live on the code examples page.

curl -s "https://apixies.io/api/v1/ip-geolocation?ip=8.8.8.8" \
  -H "X-API-Key: YOUR_API_KEY"

Response

The result sits under data in the standard envelope. See the response format guide for errors and status codes.

returns

data.country
Country name, with the ISO code in country_code.
data.city
City name, with region and zip alongside.
data.latitude
Approximate latitude, paired with longitude.
data.timezone
IANA timezone, like America/Los_Angeles.
data.isp
Internet provider, with org and AS number alongside.
example response 200
{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "IP geolocation retrieved successfully",
    "data": {
        "ip": "8.8.8.8",
        "country": "United States",
        "country_code": "US",
        "region": "VA",
        "region_name": "Virginia",
        "city": "Ashburn",
        "zip": "20149",
        "latitude": 39.03,
        "longitude": -77.5,
        "timezone": "America/New_York",
        "isp": "Google LLC",
        "org": "Google Public DNS",
        "as": "AS15169 Google LLC",
        "languages": [
            {
                "code": "en",
                "name": "English",
                "native_name": "English",
                "official": true
            },
            {
                "code": "es",
                "name": "Spanish",
                "native_name": "Espa\u00f1ol",
                "official": false
            }
        ]
    }
}

Authentication and limits

This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.

Standard rate limits apply to this endpoint.

Common use cases

Content localization

Automatically detect visitor location to show localized pricing, language, or region-specific content without requiring manual selection.

Fraud prevention

Compare the geolocation of a login attempt against the user's typical locations. Flag suspicious access from unexpected countries or regions.

Analytics enrichment

Enrich your analytics data with geographic information. Map user activity by country, city, or timezone for better business intelligence.

More documentation

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

cookies

We use analytics cookies to see how the site gets used. Nothing loads until you accept. Privacy policy