# IP2Location.io

IP2Location.io provides a fast and accurate IP Geolocation API tool to determine a user's location and use the geolocation information in different use cases.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `IP2LOCATION_IO`
- **Version:** 20260407_00

## Tools

### Bulk IP Geolocation

**Slug:** `IP2LOCATION_IO_BULK_IP_GEOLOCATION`

Tool to retrieve geolocation information for multiple IP addresses in bulk. Use when processing up to 1000 IPs at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | array | No | Optional subset of fields to include. Allowed values: country_code, country_name, region_name, city_name, latitude, longitude, zip_code, time_zone, asn, as, is_proxy |
| `format` | string ("json" | "csv") | No | Response format: 'json' or 'csv' |
| `ip_list` | array | Yes | List of IPv4 or IPv6 addresses (1-1000 entries) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Domain WHOIS Lookup

**Slug:** `IP2LOCATION_IO_DOMAIN_WHOIS`

Tool to retrieve WHOIS information for a given domain. Use when you need domain registration and contact details via IP2WHOIS API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | API key for IP2Location.io WHOIS service |
| `domain` | string | Yes | Domain name to look up, e.g., 'example.com' |
| `format` | string ("json" | "xml") | No | Response format; valid values: 'json' or 'xml' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Key

**Slug:** `IP2LOCATION_IO_GET_API_KEY`

Tool to retrieve the configured API key. Use when authentication is needed for IP2Location.io requests.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IP Geolocation

**Slug:** `IP2LOCATION_IO_GET_IP_GEOLOCATION`

Tool to retrieve comprehensive geolocation data for an IPv4 or IPv6 address. Returns location details including country, region, city, coordinates, timezone, ISP, ASN, and proxy information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IP address (IPv4 or IPv6) for geolocation lookup. If not present, the server IP address will be used. |
| `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") | No | Translation language (ISO639-1) for continent, country, region and city names. Only available for Plus and Security plans. |
| `format` | string ("json" | "xml") | No | Format of the response message. Default is json. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### IP2WHOIS Hosted Domain

**Slug:** `IP2LOCATION_IO_IP2_WHOIS_HOSTED_DOMAIN`

Tool to retrieve hosted domain names by IP address. Use when you need to list domains hosted on a given IP. Call after confirming the IP.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to lookup hosted domains |
| `page` | integer | No | Page number for pagination |
| `format` | string ("json" | "xml") | No | Response format |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |