Skip to main content
IPGeolocation.io logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 13
  • Triggers: 0
  • Slug: IPGEOLOCATION
  • Version: 20261101_00

Tools

Slug: IPGEOLOCATION_BULK_LOOKUP_IP_GEOLOCATIONReturn geolocation results for 1-50 explicit IP addresses or domains in one paid request, preserving input order and per-item errors. Credits apply per valid item and optional enrichment.

Input Parameters

array
Dot-path fields or objects to retain, serialized as a comma-separated query value.
string ("en" | "de" | "ru" | "ja" | "fr" | "cn" | "es" | "cs" | "it" | "ko" | "fa" | "pt")
Language for translated location names; non-English output requires paid access.
array
Optional modules applied to every valid item. Security adds 2 credits and Abuse adds 1 credit per item; ’*’ is intentionally not exposed.
array
Dot-path fields or objects to omit, serialized as a comma-separated query value.
array
required
IPv4 addresses, IPv6 addresses, or domains to locate. The provider allows 50,000, but this tool caps each call at 50 to bound cost and response size.

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: IPGEOLOCATION_BULK_LOOKUP_IP_SECURITYReturn threat intelligence for 1-50 IPv4 or IPv6 addresses in one paid request, preserving order and per-item errors. Costs 2 credits per valid item.

Input Parameters

array
required
IPv4 or IPv6 addresses to assess (1-50). Results preserve this order.
array
Dot-path fields or objects to retain. Sent as a comma-separated filter.
array
Dot-path fields or objects to omit. Sent as the provider’s comma-separated excludes filter.

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: IPGEOLOCATION_BULK_PARSE_USER_AGENTSParse 1-50 custom User-Agent strings in one paid request and return one ordered parser result per input. Costs 1 credit per string.

Input Parameters

array
required
User-Agent strings to parse. Each value is trimmed and must contain 1-8192 characters. This tool accepts 1-50 values to bound credits and response size.

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: IPGEOLOCATION_CONVERT_TIMEZONEConvert a supplied or current wall-clock time between two explicit timezone, place, coordinate, airport-code, or UN/LOCODE selectors of the same family. Costs 1 credit on success.

Input Parameters

string
Source-local wall time as yyyy-MM-dd HH:mm or yyyy-MM-dd HH:mm:ss. Omit to convert the current time.
string
Source timezone, location, IATA, ICAO, or UN/LOCODE value. Omit only when selector_type is coordinates.
string ("timezone" | "location" | "coordinates" | "iata" | "icao" | "unlocode")
required
Selector family shared by the source and destination.
number
Source latitude used only when selector_type is coordinates.
number
Source longitude used only when selector_type is coordinates.
string
Destination timezone, location, IATA, ICAO, or UN/LOCODE value. Omit only when selector_type is coordinates.
number
Destination latitude used only when selector_type is coordinates.
number
Destination longitude used only when selector_type is coordinates.

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: IPGEOLOCATION_GET_EXECUTION_EGRESS_IPReturn the public IP observed for the Composio execution environment. This is not the end user’s device or browser IP.

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: IPGEOLOCATION_LOOKUP_ASNReturn detailed autonomous-system metadata for one explicit IP address or ASN number, with optional topology, routes, and WHOIS data. Requires paid ASN access and costs 1 credit on success.

Input Parameters

array
Dot-path fields or objects to retain, serialized as comma-separated values.
array
Optional detailed ASN sections to include. Routes and raw WHOIS can substantially increase response size.
string ("ip" | "asn")
required
Whether lookup_value is an IPv4/IPv6 address or an autonomous system number.
string
required
IP address or ASN matching lookup_type, for example 8.8.8.8 or AS15169.
array
Dot-path fields or objects to omit, serialized as comma-separated values.

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: IPGEOLOCATION_LOOKUP_ASTRONOMYReturn Sun, Moon, twilight, golden-hour, and positional data for one explicit location and date. Costs 1 credit on success.

Input Parameters

string
Calculation date as yyyy-MM-dd. Omit to use the provider’s current date.
string ("en" | "de" | "ru" | "ja" | "fr" | "cn" | "es" | "cs" | "it" | "ko" | "fa" | "pt")
Language for translated names; non-English output requires paid access.
number
Latitude used only with coordinates; requires longitude.
number
Longitude used only with coordinates; requires latitude.
string
IANA timezone used to render event timestamps; it does not change the calculation location.
string ("coordinates" | "location" | "ip")
required
The single location selector family for the astronomy calculation.
string
Address, place, or IPv4/IPv6 value for location or ip selectors. Omit only when selector_type=coordinates.
number
Elevation above sea level in meters (0-10000).

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: IPGEOLOCATION_LOOKUP_ASTRONOMY_TIME_SERIESReturn daily Sun, Moon, twilight, and golden-hour events for one explicit location over an inclusive range of at most 90 days. Costs 1 credit per request, not per day.

Input Parameters

string
required
Inclusive end date in YYYY-MM-DD format. It must be on or after start_date, with at most 90 calendar days in the inclusive range.
string ("en" | "de" | "ru" | "ja" | "fr" | "cn" | "es" | "cs" | "it" | "ko" | "fa" | "pt")
Language for translated names; non-English output requires paid access.
number
Latitude used only with selector_type=coordinates; requires longitude.
number
Longitude used only with selector_type=coordinates; requires latitude.
string
IANA timezone used to render event timestamps.
string
required
Inclusive start date in YYYY-MM-DD format.
string ("coordinates" | "location" | "ip")
required
The single location selector family used for every day in the range.
string
Address/place or IPv4/IPv6 value for location or ip. Omit only when selector_type=coordinates.
number
Elevation above sea level in meters (0-10000).

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: IPGEOLOCATION_LOOKUP_IP_ABUSE_CONTACTReturn registry abuse contact details for one explicit IPv4 or IPv6 address, including organization, address, emails, and phone numbers. Requires paid Abuse access and costs 1 credit on success.

Input Parameters

string
required
Explicit IPv4 or IPv6 address whose abuse contact should be returned. Required to avoid looking up Composio’s egress IP.
array
Dot-path fields or objects to retain. Sent upstream as comma-separated values.
array
Dot-path fields or objects to omit. Sent upstream as comma-separated values.

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: IPGEOLOCATION_LOOKUP_IP_GEOLOCATIONReturn location, timezone, currency, ASN, and optional paid enrichments for one explicit IPv4 address, IPv6 address, or domain. Domain lookup requires a paid plan; credits depend on the fields and enrichments requested.

Input Parameters

array
Dot-path fields or objects to retain. The tool serializes the list as comma-separated values; ip is always returned.
string ("en" | "de" | "ru" | "ja" | "fr" | "cn" | "es" | "cs" | "it" | "ko" | "fa" | "pt")
Language for translated location names. Values other than en require paid access.
array
Optional paid response modules. Security adds 2 credits and Abuse adds 1 credit per successful lookup; live hostname options may add latency. The provider ’*’ shortcut is intentionally not exposed.
string
required
IPv4 address, IPv6 address, or domain to locate; domain lookup requires a paid plan. Explicit input is required to avoid locating Composio’s egress IP.
array
Dot-path fields or objects to omit. The tool serializes the list as comma-separated values; ip cannot be omitted.

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: IPGEOLOCATION_LOOKUP_IP_SECURITYReturn threat score and Tor, proxy, VPN, relay, bot, spam, attacker, and cloud-provider signals for one explicit IPv4 or IPv6 address. Requires paid Security access and costs 2 credits on success.

Input Parameters

string
required
Explicit IPv4 or IPv6 address to assess. Required to avoid assessing Composio’s egress IP.
array
Dot-path fields or objects to retain. Sent upstream as comma-separated values.
array
Dot-path fields or objects to omit. Sent upstream as comma-separated values.

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: IPGEOLOCATION_LOOKUP_TIMEZONEReturn current date, time, UTC offsets, and DST details for one explicit timezone, place, coordinate pair, IP, airport code, or UN/LOCODE. Costs 1 credit on success.

Input Parameters

string ("en" | "de" | "ru" | "ja" | "fr" | "cn" | "es" | "cs" | "it" | "ko" | "fa" | "pt")
Language for translated location names; non-English output requires paid access.
number
Latitude used only with selector_type=coordinates; requires longitude.
number
Longitude used only with selector_type=coordinates; requires latitude.
string ("timezone" | "location" | "coordinates" | "ip" | "iata" | "icao" | "unlocode")
required
The single selector family used to resolve the timezone.
string
Value for timezone, location, ip, iata, icao, or unlocode selectors. Omit only when selector_type=coordinates.

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: IPGEOLOCATION_PARSE_USER_AGENTParse one explicit User-Agent string using the operation available on the free plan. Returns browser/client, device, engine, and operating-system details and consumes 1 credit on success.

Input Parameters

string
required
User-Agent string to parse. Explicit input is required so the tool never silently parses Composio’s HTTP client header.

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