SearchCtrl+K

APIs/Bulk IP Geolocation Lookup API/Reference

Bulk IP Lookup API Reference

Geolocate thousands of IP addresses in seconds with our Bulk IP Lookup API. Get precise location data in batches for IPv4, IPv6, and hostnames with a single API call.

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

Test

The Bulk IP Lookup API allows you to geolocate up to 50,000 IP addresses per request. Each result includes detailed information such as country, region, city, coordinates, postal code, timezone, and network data for every IP in your batch.

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 'POST' \
  'https://api.apifreaks.com/v2.0/geolocation/lookup' \
  -H 'Content-Type: application/json' \
  -H 'X-apiKey: API-KEY' \
  -d '{
  "ips": [
    "8.8.8.8",
    "1.1.1.1",
    "dns.google.com"
  ]
}'

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: 21: 52.843-0700",
      "current_time_unix": 1783506112.843,
      "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
      }
    }
  },
  {
    "ip": "1.1.1.1",
    "location": {
      "continent_code": "OC",
      "continent_name": "Oceania",
      "country_code2": "AU",
      "country_code3": "AUS",
      "country_name": "Australia",
      "country_name_official": "Commonwealth of Australia",
      "country_capital": "Canberra",
      "state_prov": "Queensland",
      "state_code": "AU-QLD",
      "district": "Brisbane",
      "city": "South Brisbane",
      "zipcode": "4101",
      "latitude": "-27.47301",
      "longitude": "153.01425",
      "is_eu": false,
      "country_flag": "https://ipgeolocation.io/static/flags/au_64.png",
      "geoname_id": "10113228",
      "country_emoji": "🇦🇺"
    },
    "country_metadata": {
      "calling_code": "+61",
      "tld": ".au",
      "languages": [
        "en-AU"
      ]
    },
    "network": {
      "connection_type": "",
      "route": "1.1.1.0/24",
      "is_anycast": true
    },
    "currency": {
      "code": "AUD",
      "name": "Australian Dollar",
      "symbol": "A$"
    },
    "asn": {
      "as_number": "AS13335",
      "organization": "Cloudflare, Inc.",
      "country": "US",
      "type": "BUSINESS",
      "domain": "cloudflare.com",
      "date_allocated": "2010-07-14",
      "rir": "ARIN"
    },
    "company": {
      "name": "APNIC Research and Development",
      "type": "",
      "domain": ""
    },
    "time_zone": {
      "name": "Australia/Brisbane",
      "offset": 10,
      "offset_with_dst": 10,
      "current_time": "2026-07-08 20: 21: 52.843+1000",
      "current_time_unix": 1783506112.843,
      "current_tz_abbreviation": "AEST",
      "current_tz_full_name": "Australian Eastern Standard Time",
      "standard_tz_abbreviation": "AEST",
      "standard_tz_full_name": "Australian Eastern Standard Time",
      "is_dst": false,
      "dst_savings": 0,
      "dst_exists": false,
      "dst_tz_abbreviation": "",
      "dst_tz_full_name": "",
      "dst_start": {},
      "dst_end": {}
    }
  },
  {
    "domain": "dns.google.com",
    "ip": "8.8.4.4",
    "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.4.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: 21: 52.844-0700",
      "current_time_unix": 1783506112.844,
      "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 query parameters can be used in your API requests.

formatoptionalStringdefault: json

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

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

Request Body

The request body should be in JSON format and include an ips array of IP addresses or hostnames for geolocation.

{
  "ips": [
    "8.8.8.8",
    "1.1.1.1",
    "dns.google.com"
  ]
}

ipsrequiredArray<String>

Array of IP addresses (IPv4 or IPv6) or hostnames to geolocate. Maximum 50,000 per request.

API Response Schema

A successful request returns a 200 OK response with a JSON array of objects. Each object in the array contains the geolocation data for the corresponding IP address in the request. The response structure for each item is identical to the IP Location API response.

To see the complete response structure, click here.

Error Status & Codes

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

400

'ip' must not be empty or null

Bulk IP Lookup API Reference

Geolocate thousands of IP addresses in seconds with our Bulk IP Lookup API. Get precise location data in batches for IPv4, IPv6, and hostnames with a single API call.

POSThttps://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 'POST' \
  'https://api.apifreaks.com/v2.0/geolocation/lookup' \
  -H 'Content-Type: application/json' \
  -H 'X-apiKey: API-KEY' \
  -d '{
  "ips": [
    "8.8.8.8",
    "1.1.1.1",
    "dns.google.com"
  ]
}'

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: 21: 52.843-0700",
      "current_time_unix": 1783506112.843,
      "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
      }
    }
  },
  {
    "ip": "1.1.1.1",
    "location": {
      "continent_code": "OC",
      "continent_name": "Oceania",
      "country_code2": "AU",
      "country_code3": "AUS",
      "country_name": "Australia",
      "country_name_official": "Commonwealth of Australia",
      "country_capital": "Canberra",
      "state_prov": "Queensland",
      "state_code": "AU-QLD",
      "district": "Brisbane",
      "city": "South Brisbane",
      "zipcode": "4101",
      "latitude": "-27.47301",
      "longitude": "153.01425",
      "is_eu": false,
      "country_flag": "https://ipgeolocation.io/static/flags/au_64.png",
      "geoname_id": "10113228",
      "country_emoji": "🇦🇺"
    },
    "country_metadata": {
      "calling_code": "+61",
      "tld": ".au",
      "languages": [
        "en-AU"
      ]
    },
    "network": {
      "connection_type": "",
      "route": "1.1.1.0/24",
      "is_anycast": true
    },
    "currency": {
      "code": "AUD",
      "name": "Australian Dollar",
      "symbol": "A$"
    },
    "asn": {
      "as_number": "AS13335",
      "organization": "Cloudflare, Inc.",
      "country": "US",
      "type": "BUSINESS",
      "domain": "cloudflare.com",
      "date_allocated": "2010-07-14",
      "rir": "ARIN"
    },
    "company": {
      "name": "APNIC Research and Development",
      "type": "",
      "domain": ""
    },
    "time_zone": {
      "name": "Australia/Brisbane",
      "offset": 10,
      "offset_with_dst": 10,
      "current_time": "2026-07-08 20: 21: 52.843+1000",
      "current_time_unix": 1783506112.843,
      "current_tz_abbreviation": "AEST",
      "current_tz_full_name": "Australian Eastern Standard Time",
      "standard_tz_abbreviation": "AEST",
      "standard_tz_full_name": "Australian Eastern Standard Time",
      "is_dst": false,
      "dst_savings": 0,
      "dst_exists": false,
      "dst_tz_abbreviation": "",
      "dst_tz_full_name": "",
      "dst_start": {},
      "dst_end": {}
    }
  },
  {
    "domain": "dns.google.com",
    "ip": "8.8.4.4",
    "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.4.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: 21: 52.844-0700",
      "current_time_unix": 1783506112.844,
      "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 query parameters can be used in your API requests.

formatoptionalStringdefault: json

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

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

Request Body

The request body should be in JSON format and include an ips array of IP addresses or hostnames for geolocation.

{
  "ips": [
    "8.8.8.8",
    "1.1.1.1",
    "dns.google.com"
  ]
}

ipsrequiredArray<String>

Array of IP addresses (IPv4 or IPv6) or hostnames to geolocate. Maximum 50,000 per request.

API Response Schema

To see the complete response structure, click here.

Error Status & Codes

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

400

'ip' must not be empty or null

Quick Links

Quick Links

Bulk IP Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

Request Body

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts

Quick Links

Quick Links

Bulk IP Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

Request Body

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts