> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ip2Location

> IP2Location.io provides fast and accurate IP geolocation data, including country, city, ISP, latitude, longitude, and more, supporting both IPv4 and IPv6 lookups.

![Ip2Location logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/ip2location.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=2f8fbab76e2cdb91be7299d44364498f)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `IP2LOCATION`
* **Version:** 20261101\_00

## Tools

> [accordion] Bulk IP Geolocation
>
> **Slug:** `IP2LOCATION_BULK_IP_GEOLOCATION`
>
> Look up geolocation for 1–1000 IPv4 or IPv6 addresses in JSON or CSV, with optional field selection. Results may include location, coordinates, time zone, ASN and proxy information, depending on the plan. The bulk service requires a paid plan; if individual fallback lookups are attempted, failed lookups can appear as placeholder values rather than explicit per-IP errors.
>
> #### Input Parameters
>
> **ips** `array` *required*
>
> List of IPv4 or IPv6 addresses to look up (1 to 1000 entries).
>
> **fields** `array`
>
> Optional subset of fields to return; if omitted, all fields are returned.
>
> **format** `string ("json" | "csv")`
>
> Response format: 'json' for structured data or 'csv' for raw CSV text.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check IP2Location API Credits
>
> **Slug:** `IP2LOCATION_CHECK_CREDITS`
>
> Tool to check remaining IP2Location API credits. Use after setting up authentication to monitor usage.
>
> #### Input Parameters
>
> **key** `string`
>
> API key for IP2Location; if omitted, uses the metadata-configured key.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP2Location Distance Calculator
>
> **Slug:** `IP2LOCATION_DISTANCE`
>
> Calculate the great-circle distance between two IP addresses based on their geographic locations. This tool looks up the geolocation (latitude/longitude) for each IP address and calculates the shortest distance between them over the Earth's surface using the Haversine formula. Supports both IPv4 and IPv6 addresses. Returns the distance in kilometers along with the coordinates of both IPs. Use when you need to determine geographic separation between two IP addresses, such as for latency estimation, geographic analysis, or network optimization.
>
> #### Input Parameters
>
> **ip1** `string` *required*
>
> First IPv4 or IPv6 address
>
> **ip2** `string` *required*
>
> Second IPv4 or IPv6 address
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP2WHOIS Hosted Domains Lookup
>
> **Slug:** `IP2LOCATION_GET_HOSTED_DOMAINS`
>
> Retrieves a list of domain names hosted on a specific IP address (IPv4 or IPv6). Use this tool when you need to: - Discover which domains are hosted on a particular IP - Investigate shared hosting environments - Analyze domain-to-IP relationships The API supports pagination for IPs with many hosted domains.
>
> #### Input Parameters
>
> **ip** `string` *required*
>
> IPv4 or IPv6 address to query. Returns a list of domain names that are hosted on this IP address.
>
> **key** `string` *required*
>
> IP2WHOIS API key for accessing the Hosted Domains API. Required for authentication.
>
> **page** `integer`
>
> Page number for pagination (must be >= 1). Use with 'total\_pages' in response to retrieve all results. Defaults to 1.
>
> **format** `string ("json" | "xml")`
>
> Response format. Accepts 'json' or 'xml'. Defaults to 'json'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP2Location Get IP Geolocation
>
> **Slug:** `IP2LOCATION_GET_IP_GEOLOCATION`
>
> Tool to retrieve geolocation data for an IP address. Use when detailed IP location info is needed.
>
> #### Input Parameters
>
> **ip** `string` *required*
>
> IPv4 or IPv6 address to look up
>
> **lang** `string ("ar" | "cs" | "da" | "de" | "en" | "es" | "et" | "fi" | "fr" | "ga" | "it" | "ja" | "ko" | "ms" | "nl" | "pt" | "ru" | "sv" | "tr" | "vi" | "zh-cn" | "zh-tw")`
>
> Translation language for certain addon fields; valid values as ISO language codes
>
> **addon** `array`
>
> Extra data to include; valid values: continent, country, region, city, geotargeting, country\_groupings, time\_zone\_info
>
> **format** `string ("json" | "xml")`
>
> Response format; default is json
>
> **package** `string ("WS1" | "WS2" | "WS3" | "WS4" | "WS5" | "WS6" | "WS7" | "WS8" | "WS9" | "WS10" | "WS11" | "WS12" | "WS13" | "WS14" | "WS15" | "WS16" | "WS17" | "WS18" | "WS19" | "WS20" | "WS21" | "WS22" | "WS23" | "WS24" | "WS25")` *required*
>
> Web service package controlling which fields are returned; valid values WS1–WS25
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP2Proxy: Get Proxy Detection
>
> **Slug:** `IP2LOCATION_GET_PROXY_DETECTION`
>
> Check an IPv4 or IPv6 address for proxy, VPN, or Tor use with IP2Proxy, choosing the level of lookup detail or requesting remaining credits. If a fallback lookup is used, a missing proxy indicator is reported as NO. New registrations for IP2Proxy are no longer available; the provider recommends IP2Location.io.
>
> #### Input Parameters
>
> **ip** `string` *required*
>
> IPv4 or IPv6 address to check for proxy/VPN/TOR usage
>
> **check** `integer`
>
> Set to 1 to return only remaining credits instead of lookup data
>
> **package** `string ("PX1" | "PX2" | "PX3" | "PX4" | "PX5" | "PX6" | "PX7" | "PX8" | "PX9" | "PX10" | "PX11")`
>
> Level of detail/package (PX1=basic to PX11=full)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP2WHOIS Domain WHOIS Lookup
>
> **Slug:** `IP2LOCATION_IP2_WHOIS_DOMAIN_WHOIS`
>
> Tool to retrieve WHOIS information for a domain. Use when you need domain registration details.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Domain name to query, e.g. 'example.com'
>
> **format** `string ("json" | "xml")`
>
> Response format; either 'json' or 'xml'. Defaults to 'json'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] IP2Location List IPs
>
> **Slug:** `IP2LOCATION_LIST_IPS`
>
> Tool to list a curated set of test IPv4 and IPv6 addresses. Use when sample IPs are needed for IP2Location or IP2Proxy lookups during development or testing.
>
> #### Input Parameters
>
> **type** `string ("ipv4" | "ipv6" | "all")`
>
> IP version filter: 'ipv4', 'ipv6', or 'all' to return both.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
