SearchCtrl+K

IP Geolocation API Reference

Fast, reliable, and RESTful JSON API for geolocating IP addresses worldwide. Get detailed location data, network information, and more with a single API call.

GEThttps://api.apifreaks.com/v2.0/geolocation/lookup

Test

The IP Location API allows you to track IP address locations with precision, providing detailed information such as country, region, city, coordinates, postal code, and timezone. Perfect for enhancing user insights, improving geographic analysis, and powering location-based features in your applications.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version 2.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v2.0/geolocation/lookup?ip=8.8.8.8' \
  -H 'X-apiKey: API-KEY'

Response

{
  "ip": "8.8.8.8",
  "location": {
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code2": "US",
    "country_code3": "USA",
    "country_name": "United States",
    "country_name_official": "United States of America",
    "country_capital": "Washington, D.C.",
    "state_prov": "California",
    "state_code": "US-CA",
    "district": "Santa Clara",
    "city": "Mountain View",
    "zipcode": "94043-1351",
    "latitude": "37.42240",
    "longitude": "-122.08421",
    "is_eu": false,
    "country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
    "geoname_id": "6301403",
    "country_emoji": "🇺🇸"
  },
  "country_metadata": {
    "calling_code": "+1",
    "tld": ".us",
    "languages": [
      "en-US",
      "es-US",
      "haw",
      "fr"
    ]
  },
  "network": {
    "connection_type": "",
    "route": "8.8.8.0/24",
    "is_anycast": true
  },
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$"
  },
  "asn": {
    "as_number": "AS15169",
    "organization": "Google LLC",
    "country": "US",
    "type": "BUSINESS",
    "domain": "google.com",
    "date_allocated": "2000-03-30",
    "rir": "ARIN"
  },
  "company": {
    "name": "Google LLC",
    "type": "HOSTING",
    "domain": "google.com"
  },
  "time_zone": {
    "name": "America/Los_Angeles",
    "offset": -8,
    "offset_with_dst": -7,
    "current_time": "2026-07-08 03: 03: 31.835-0700",
    "current_time_unix": 1783505011.835,
    "current_tz_abbreviation": "PDT",
    "current_tz_full_name": "Pacific Daylight Time",
    "standard_tz_abbreviation": "PST",
    "standard_tz_full_name": "Pacific Standard Time",
    "is_dst": true,
    "dst_savings": 1,
    "dst_exists": true,
    "dst_tz_abbreviation": "PDT",
    "dst_tz_full_name": "Pacific Daylight Time",
    "dst_start": {
      "utc_time": "2026-03-08 TIME 10: 00",
      "duration": "+1.00H",
      "gap": true,
      "date_time_after": "2026-03-08 TIME 03: 00",
      "date_time_before": "2026-03-08 TIME 02: 00",
      "overlap": false
    },
    "dst_end": {
      "utc_time": "2026-11-01 TIME 09: 00",
      "duration": "-1.00H",
      "gap": false,
      "date_time_after": "2026-11-01 TIME 01: 00",
      "date_time_before": "2026-11-01 TIME 02: 00",
      "overlap": true
    }
  }
}

API Request

Query Parameters

The following parameters can be used in your API requests. All parameters are passed as query string parameters.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

ipoptionalString

IPv4, IPv6, or hostname whose geolocation lookup is required

langoptionalStringdefault: en

Response language. Possible values are:

1.en (English)
2.de (German)
3.ru (Russian)
4.ja (Japanese)
5.fr (French)
6.cn (Chinese Simplified)
7.es (Spanish)
8.cs (Czech)
9.it (Italian)
10.ko (Korean)
11.fa (Persian)
12.pt (Portuguese)

fieldsoptionalArray

Comma separated list of fields to be included in the response. For example, `location` includes all location fields, `location.city` is a specific field. See the response fields section for more details.

excludesoptionalArray

Comma separated list of fields except ip to be excluded in the response

includeoptionalArray

Possible values are:

1.security - To add IP security information
2.hostname - hostname lookup from IP-Hostname database
3.liveHostname - hostname lookup from live sources
4.hostnameFallbackLive - hostname lookup from IP-Hostname database, fallback to live sources
5.user_agent - To parse user-agent information from "User-Agent" header
6.abuse - To add IP abuse contact information
7.dma_code - To add DMA code information
8.geo_accuracy - To add geo accuracy fields (accuracy_radius, confidence, locality)
9.* - To include all additional data modules

API Response Schema

A successful request returns a 200 OK response with a JSON object containing the geolocation data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.

ip

Stringmandatory

The IP address used for the lookup (IPv4 or IPv6).

domain

Stringoptional

The input domain, returned only for domain-based lookups.

hostname

Stringoptional

Reverse DNS hostname (PTR) for the input IP; returns the input IP if not resolvable.

continent_code (String), continent_name (String), country_code2 (String), country_code3 (String), country_name (String), …

calling_code (String), tld (String), languages (Array)

connection_type (String), route (String), is_anycast (Boolean)

as_number (String), organization (String), country (String), type (String), domain (String), …

name (String), type (String), domain (String)

code (String), name (String), symbol (String)

threat_score (Integer), is_tor (Boolean), is_proxy (Boolean), proxy_provider_names (Array<String>), proxy_confidence_score (Integer), …

route (String), country (String), name (String), organization (String), kind (String), …

name (String), offset (Float), offset_with_dst (Float), current_time (String), current_time_unix (Float), …

user_agent_string (String), name (String), type (String), version (String), version_major (String), …

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

The request was unacceptable. Typically due to missing or invalid parameters.

404

Provided IP address '255.255.255.255' doesn't exist in our database.

423

'127.0.0.1' is a bogon (Internet Assigned Numbers Authority) IP address.

IP Geolocation API Reference

Fast, reliable, and RESTful JSON API for geolocating IP addresses worldwide. Get detailed location data, network information, and more with a single API call.

GEThttps://api.apifreaks.com/v2.0/geolocation/lookup

Test

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version 2.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v2.0/geolocation/lookup?ip=8.8.8.8' \
  -H 'X-apiKey: API-KEY'

Response

{
  "ip": "8.8.8.8",
  "location": {
    "continent_code": "NA",
    "continent_name": "North America",
    "country_code2": "US",
    "country_code3": "USA",
    "country_name": "United States",
    "country_name_official": "United States of America",
    "country_capital": "Washington, D.C.",
    "state_prov": "California",
    "state_code": "US-CA",
    "district": "Santa Clara",
    "city": "Mountain View",
    "zipcode": "94043-1351",
    "latitude": "37.42240",
    "longitude": "-122.08421",
    "is_eu": false,
    "country_flag": "https://ipgeolocation.io/static/flags/us_64.png",
    "geoname_id": "6301403",
    "country_emoji": "🇺🇸"
  },
  "country_metadata": {
    "calling_code": "+1",
    "tld": ".us",
    "languages": [
      "en-US",
      "es-US",
      "haw",
      "fr"
    ]
  },
  "network": {
    "connection_type": "",
    "route": "8.8.8.0/24",
    "is_anycast": true
  },
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "symbol": "$"
  },
  "asn": {
    "as_number": "AS15169",
    "organization": "Google LLC",
    "country": "US",
    "type": "BUSINESS",
    "domain": "google.com",
    "date_allocated": "2000-03-30",
    "rir": "ARIN"
  },
  "company": {
    "name": "Google LLC",
    "type": "HOSTING",
    "domain": "google.com"
  },
  "time_zone": {
    "name": "America/Los_Angeles",
    "offset": -8,
    "offset_with_dst": -7,
    "current_time": "2026-07-08 03: 03: 31.835-0700",
    "current_time_unix": 1783505011.835,
    "current_tz_abbreviation": "PDT",
    "current_tz_full_name": "Pacific Daylight Time",
    "standard_tz_abbreviation": "PST",
    "standard_tz_full_name": "Pacific Standard Time",
    "is_dst": true,
    "dst_savings": 1,
    "dst_exists": true,
    "dst_tz_abbreviation": "PDT",
    "dst_tz_full_name": "Pacific Daylight Time",
    "dst_start": {
      "utc_time": "2026-03-08 TIME 10: 00",
      "duration": "+1.00H",
      "gap": true,
      "date_time_after": "2026-03-08 TIME 03: 00",
      "date_time_before": "2026-03-08 TIME 02: 00",
      "overlap": false
    },
    "dst_end": {
      "utc_time": "2026-11-01 TIME 09: 00",
      "duration": "-1.00H",
      "gap": false,
      "date_time_after": "2026-11-01 TIME 01: 00",
      "date_time_before": "2026-11-01 TIME 02: 00",
      "overlap": true
    }
  }
}

API Request

Query Parameters

The following parameters can be used in your API requests. All parameters are passed as query string parameters.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

ipoptionalString

IPv4, IPv6, or hostname whose geolocation lookup is required

langoptionalStringdefault: en

Response language. Possible values are:

1.en (English)
2.de (German)
3.ru (Russian)
4.ja (Japanese)
5.fr (French)
6.cn (Chinese Simplified)
7.es (Spanish)
8.cs (Czech)
9.it (Italian)
10.ko (Korean)
11.fa (Persian)
12.pt (Portuguese)

fieldsoptionalArray

excludesoptionalArray

Comma separated list of fields except ip to be excluded in the response

includeoptionalArray

Possible values are:

1.security - To add IP security information
2.hostname - hostname lookup from IP-Hostname database
3.liveHostname - hostname lookup from live sources
4.hostnameFallbackLive - hostname lookup from IP-Hostname database, fallback to live sources
5.user_agent - To parse user-agent information from "User-Agent" header
6.abuse - To add IP abuse contact information
7.dma_code - To add DMA code information
8.geo_accuracy - To add geo accuracy fields (accuracy_radius, confidence, locality)
9.* - To include all additional data modules

API Response Schema

ip

Stringmandatory

The IP address used for the lookup (IPv4 or IPv6).

domain

Stringoptional

The input domain, returned only for domain-based lookups.

hostname

Stringoptional

Reverse DNS hostname (PTR) for the input IP; returns the input IP if not resolvable.

continent_code (String), continent_name (String), country_code2 (String), country_code3 (String), country_name (String), …

calling_code (String), tld (String), languages (Array)

connection_type (String), route (String), is_anycast (Boolean)

as_number (String), organization (String), country (String), type (String), domain (String), …

name (String), type (String), domain (String)

code (String), name (String), symbol (String)

threat_score (Integer), is_tor (Boolean), is_proxy (Boolean), proxy_provider_names (Array<String>), proxy_confidence_score (Integer), …

route (String), country (String), name (String), organization (String), kind (String), …

name (String), offset (Float), offset_with_dst (Float), current_time (String), current_time_unix (Float), …

user_agent_string (String), name (String), type (String), version (String), version_major (String), …

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

The request was unacceptable. Typically due to missing or invalid parameters.

404

Provided IP address '255.255.255.255' doesn't exist in our database.

423

'127.0.0.1' is a bogon (Internet Assigned Numbers Authority) IP address.

Quick Links

Quick Links

IP Geolocation API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts

Quick Links

Quick Links

IP Geolocation API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts