Skip to main content
Ip2Location logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: IP2LOCATION
  • Version: 20261101_00

Tools

Slug: IP2LOCATION_BULK_IP_GEOLOCATIONLook 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

array
required
List of IPv4 or IPv6 addresses to look up (1 to 1000 entries).
array
Optional subset of fields to return; if omitted, all fields are returned.
string ("json" | "csv")
Response format: ‘json’ for structured data or ‘csv’ for raw CSV text.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_CHECK_CREDITSTool to check remaining IP2Location API credits. Use after setting up authentication to monitor usage.

Input Parameters

string
API key for IP2Location; if omitted, uses the metadata-configured key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_DISTANCECalculate 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

string
required
First IPv4 or IPv6 address
string
required
Second IPv4 or IPv6 address

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_GET_HOSTED_DOMAINSRetrieves 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

string
required
IPv4 or IPv6 address to query. Returns a list of domain names that are hosted on this IP address.
string
required
IP2WHOIS API key for accessing the Hosted Domains API. Required for authentication.
integer
Page number for pagination (must be >= 1). Use with ‘total_pages’ in response to retrieve all results. Defaults to 1.
string ("json" | "xml")
Response format. Accepts ‘json’ or ‘xml’. Defaults to ‘json’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_GET_IP_GEOLOCATIONTool to retrieve geolocation data for an IP address. Use when detailed IP location info is needed.

Input Parameters

string
required
IPv4 or IPv6 address to look up
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
array
Extra data to include; valid values: continent, country, region, city, geotargeting, country_groupings, time_zone_info
string ("json" | "xml")
Response format; default is json
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_GET_PROXY_DETECTIONCheck 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

string
required
IPv4 or IPv6 address to check for proxy/VPN/TOR usage
integer
Set to 1 to return only remaining credits instead of lookup data
string ("PX1" | "PX2" | "PX3" | "PX4" | "PX5" | "PX6" | "PX7" | "PX8" | "PX9" | "PX10" | "PX11")
Level of detail/package (PX1=basic to PX11=full)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_IP2_WHOIS_DOMAIN_WHOISTool to retrieve WHOIS information for a domain. Use when you need domain registration details.

Input Parameters

string
required
Domain name to query, e.g. ‘example.com’
string ("json" | "xml")
Response format; either ‘json’ or ‘xml’. Defaults to ‘json’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IP2LOCATION_LIST_IPSTool 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

string ("ipv4" | "ipv6" | "all")
IP version filter: ‘ipv4’, ‘ipv6’, or ‘all’ to return both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not