SearchCtrl+K

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.

POST

https://api.apifreaks.com/v1.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 v1.0 of the API.

LANGUAGE

curl -X 'POST' \
  'https://api.apifreaks.com/v1.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",
      "locality": "Mountain View",
      "accuracy_radius": "39.202",
      "confidence": "low",
      "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": {
      "asn": {
        "as_number": "AS15169",
        "organization": "Google LLC",
        "country": "US",
        "asn_name": "GOOGLE",
        "type": "BUSINESS",
        "domain": "google.com",
        "date_allocated": "2000-03-30",
        "allocation_status": "",
        "num_of_ipv4_routes": "1064",
        "num_of_ipv6_routes": "155",
        "rir": "ARIN"
      },
      "connection_type": "",
      "company": {
        "name": "Google LLC",
        "type": "Hosting",
        "domain": "google.com"
      }
    },
    "currency": {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$"
    }
  },
  {
    "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",
      "locality": "South Brisbane",
      "accuracy_radius": "12.582",
      "confidence": "medium",
      "zipcode": "4101",
      "latitude": "-27.47306",
      "longitude": "153.01421",
      "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": {
      "asn": {
        "as_number": "AS13335",
        "organization": "Cloudflare, Inc.",
        "country": "US",
        "asn_name": "CLOUDFLARENET",
        "type": "BUSINESS",
        "domain": "cloudflare.com",
        "date_allocated": "2010-07-14",
        "allocation_status": "",
        "num_of_ipv4_routes": "2472",
        "num_of_ipv6_routes": "3088",
        "rir": "ARIN"
      },
      "connection_type": "",
      "company": {
        "name": "APNIC Research and Development",
        "type": "",
        "domain": ""
      }
    },
    "currency": {
      "code": "AUD",
      "name": "Australian Dollar",
      "symbol": "A$"
    }
  },
  {
    "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",
      "locality": "Mountain View",
      "accuracy_radius": "20.121",
      "confidence": "low",
      "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": {
      "asn": {
        "as_number": "AS15169",
        "organization": "Google LLC",
        "country": "US",
        "asn_name": "GOOGLE",
        "type": "BUSINESS",
        "domain": "google.com",
        "date_allocated": "2000-03-30",
        "allocation_status": "",
        "num_of_ipv4_routes": "1064",
        "num_of_ipv6_routes": "155",
        "rir": "ARIN"
      },
      "connection_type": "",
      "company": {
        "name": "Google LLC",
        "type": "Hosting",
        "domain": "google.com"
      }
    },
    "currency": {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$"
    }
  }
]

API Request Parameters

The following query parameters can be used in your API requests.

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)

fieldsoptionalString

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.

excludesoptionalString

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

includeoptionalString

Possible values are:

1.security - To add ip security information
2.hostname - hostname lookup from IP-Hostname database and returns the same IP address if there is no hostname found for the queried IP address
3.liveHostname - hostname lookup from live sources
4.hostnameFallbackLive - hostname lookup from IP-Hostname database and if there is no hostname found for the queried IP address, then lookup through the live sources
5.user_agent - To parse user-agent information from "User-Agent" header
6.abuse - To add IP abuse contact information
7.dma - To add IP DMA information
8.time_zone - To add IP time zone information

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"
    ]
}

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

The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.

400

'ip' must not be empty or null