> ## 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.

# BigDataCloud

> BigDataCloud offers a suite of APIs providing geolocation, reverse geocoding, and data validation services.

![BigDataCloud logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/big_data_cloud.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=6c9c264ab66b2ee02295a189be5aab84)

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

## Tools

> [accordion] Am I Roaming API
>
> **Slug:** `BIG_DATA_CLOUD_AM_I_ROAMING_API`
>
> Tool to determine if the user is roaming based on their IP address and GPS coordinates. Use after obtaining device location to verify roaming status before mobile actions.
>
> #### Input Parameters
>
> **latitude** `number` *required*
>
> Latitude value as per WGS 84 reference system, must be between -90 and 90.
>
> **longitude** `number` *required*
>
> Longitude value as per WGS 84 reference system, must be between -180 and 180.
>
> #### 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] ASN Extended Receiving From Info API
>
> **Slug:** `BIG_DATA_CLOUD_ASN_EXTENDED_RECEIVING_FROM_INFO_API`
>
> Tool to return upstream providers (receivingFrom) for a given ASN. Use when you need a paginated list of ASes feeding traffic for the specified ASN.
>
> #### Input Parameters
>
> **asn** `string` *required*
>
> Autonomous System Number, either numeric (e.g., '123'), 'AS123', or 'ASN123'.
>
> **offset** `integer` *required*
>
> Number of receivingFrom entries to skip for pagination.
>
> **batchSize** `integer` *required*
>
> Number of receivingFrom entries to retrieve; hard limit is 50.
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format (default: 'en'); falls back to English or native names if unavailable.
>
> #### 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] ASN Extended Transit To Info API
>
> **Slug:** `BIG_DATA_CLOUD_ASN_EXTENDED_TRANSIT_TO_INFO_API`
>
> Tool to return downstream customers (transitTo) for a given ASN. Use when you need a paginated list of ASes receiving traffic from a specific ASN.
>
> #### Input Parameters
>
> **asn** `string` *required*
>
> Autonomous System Number as numeric or ASN format (e.g. '123', 'AS123', 'ASN123')
>
> **offset** `integer` *required*
>
> Number of transitTo entries to skip
>
> **batchSize** `integer` *required*
>
> Number of transitTo entries to retrieve (max 50)
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format, default 'en'. Falls back to English or native name if unavailable.
>
> #### 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] ASN Rank List API
>
> **Slug:** `BIG_DATA_CLOUD_ASN_RANK_LIST_API`
>
> Retrieves a paginated list of ranked Autonomous Systems with IPv4 announcement counts. Results can be sorted by rank, ASN, organisation or country, with a total count for navigation.
>
> #### Input Parameters
>
> **sort** `string ("rank" | "asn" | "asnNumeric" | "organisation" | "countryCode")`
>
> Field to sort results by. Options: 'rank' (by IPv4 count), 'asn' (AS number string), 'asnNumeric' (AS number integer), 'organisation', 'countryCode'. Default: 'rank'.
>
> **order** `string ("asc" | "desc")`
>
> Sort order: 'asc' (ascending) or 'desc' (descending). Default: 'asc'. For rank, 'asc' returns largest ASNs first (rank 1, 2, 3...).
>
> **offset** `integer`
>
> Number of entries to skip for pagination. Default: 0. Use with batchSize to paginate through results.
>
> **batchSize** `integer`
>
> Number of ASN entries to return per request. Default: 10. Max: 1000.
>
> **localityLanguage** `string`
>
> ISO 639-1 language code for country names (e.g., 'en', 'es', 'fr', 'de', 'zh'). Default: 'en'.
>
> #### 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] BGP Active Prefixes API
>
> **Slug:** `BIG_DATA_CLOUD_BGP_ACTIVE_PREFIXES_API`
>
> Tool to retrieve IPv4 or IPv6 prefixes currently announced on BGP. Use when inspecting BGP routing announcements for a given ASN.
>
> #### Input Parameters
>
> **asn** `string` *required*
>
> Autonomous System Number as numeric or ASN format (e.g., '123', 'AS123', or 'ASN123')
>
> **isv4** `boolean`
>
> True for IPv4 prefixes only, False for IPv6 prefixes
>
> **sort** `string ("bgpPrefix" | "bgpPrefixNetworkAddress" | "bgpPrefixLastAddress" | "registryStatus" | "isBogon" | "isAnnounced" | "carriers")`
>
> Field to sort by
>
> **order** `string ("asc" | "desc")`
>
> Sort order
>
> **offset** `integer`
>
> Offset, number of entries to skip
>
> **batchSize** `integer`
>
> Requested batch size (max 1000)
>
> **bogonsOnly** `boolean`
>
> Limit to bogon routes only or not
>
> **localityLanguage** `string`
>
> Preferred language for locality names (ISO 639-1 code)
>
> #### 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] Country by IP Address API
>
> **Slug:** `BIG_DATA_CLOUD_COUNTRY_BY_IP_ADDRESS_API`
>
> Tool to geolocate an IP address and retrieve country details and demographics. Use when you need country-level data after obtaining the target IP address.
>
> #### Input Parameters
>
> **ip** `string`
>
> IPv4 or IPv6 address. If omitted, caller's IP is assumed.
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format, e.g., 'en'; use 'default' to select the first administrative language.
>
> #### 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] Country Info API
>
> **Slug:** `BIG_DATA_CLOUD_COUNTRY_INFO_API`
>
> Tool to fetch detailed country information by ISO code. Use when you need localized names, currencies, regions, and other metadata for a country.
>
> #### Input Parameters
>
> **code** `string` *required*
>
> Country code in ISO 3166-1 Alpha-2 (e.g., 'US'), Alpha-3 (e.g., 'USA'), or numeric (e.g., '840') format.
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format, such as 'en', 'es'. Defaults to 'en' and falls back to native names if unavailable.
>
> #### 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] Email Address Verification API
>
> **Slug:** `BIG_DATA_CLOUD_EMAIL_ADDRESS_VERIFICATION_API`
>
> Tool to verify email addresses for syntax, domain validity, and disposability. Use after obtaining the email input.
>
> #### Input Parameters
>
> **emailAddress** `string` *required*
>
> The email address to verify. Must be a valid email format.
>
> #### 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] Hazard Report API
>
> **Slug:** `BIG_DATA_CLOUD_HAZARD_REPORT_API`
>
> Tool to fetch a cybersecurity hazard report for a specified IP address. Use when assessing an IP's threat profile (VPN, proxy, blacklists, hosting risk).
>
> #### Input Parameters
>
> **ip** `string`
>
> IPv4 or IPv6 address. If omitted, the caller's IP address is assumed.
>
> #### 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] Networks by CIDR
>
> **Slug:** `BIG_DATA_CLOUD_NETWORK_BY_CIDR`
>
> Tool to retrieve BGP-announced networks within a specified CIDR range. Use when you need to analyze network announcements within a particular CIDR after confirming the range format.
>
> #### Input Parameters
>
> **cidr** `string` *required*
>
> CIDR range in 'x.x.x.x/y' format. x: 0-255, y: 0-32.
>
> **bogonsOnly** `boolean`
>
> If true, returns only bogon networks.
>
> **depthLimit** `integer`
>
> How many hierarchical levels down to include in the response.
>
> **subnetsOffset** `integer`
>
> Number of subnetwork entries to skip.
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format, e.g., 'en', 'es'.
>
> **subnetsBatchSize** `integer`
>
> Number of subnetwork entries to retrieve (max 20).
>
> #### 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] Network by IP Address API
>
> **Slug:** `BIG_DATA_CLOUD_NETWORK_BY_IP_ADDRESS_API`
>
> Tool to retrieve registry, ASN, and BGP details for a given IP address’s network. Use when you need detailed network information (e.g., ASNs, prefixes) after confirming the target IP.
>
> #### Input Parameters
>
> **ip** `string`
>
> IPv4 IP address in a string or numeric format, or IPv6 address. If omitted, the caller's IP address is assumed.
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format, such as 'en', 'es'; defaults to 'en'.
>
> #### 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] Phone Number Validation by IP
>
> **Slug:** `BIG_DATA_CLOUD_PHONE_NUMBER_VALIDATION_BY_IP`
>
> Tool to validate phone numbers by inferring country from client IP. Use when you want to validate a number without specifying country.
>
> #### Input Parameters
>
> **ip** `string`
>
> IPv4 or IPv6 address. If omitted, uses caller's IP
>
> **number** `string` *required*
>
> Phone number to validate
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format
>
> #### 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] Reverse Geocoding With Timezone API
>
> **Slug:** `BIG_DATA_CLOUD_REVERSE_GEOCODING_TIMEZONE_API`
>
> Tool to return reverse geocoding and time zone info for given coordinates. Use when you need both locality details and timezone data in one call.
>
> #### Input Parameters
>
> **latitude** `number` *required*
>
> Latitude value as per WGS 84 reference system (GPS). Range: -90 to 90.
>
> **longitude** `number` *required*
>
> Longitude value as per WGS 84 reference system (GPS). Range: -180 to 180.
>
> **localityLanguage** `string`
>
> Preferred language for locality names in ISO 639-1 format, such as 'en', 'es'. Defaults to 'en'. Use 'default' to adjust to first administrative language.
>
> #### 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] Time Zone by IP Address API
>
> **Slug:** `BIG_DATA_CLOUD_TIME_ZONE_BY_IP_ADDRESS_API`
>
> Tool to retrieve time zone information for a given IP address. Use when you need DST status, UTC offsets, and local/UTC time for a specific IP.
>
> #### Input Parameters
>
> **ip** `string`
>
> IPv4 or IPv6 address. Defaults to caller's IP if omitted.
>
> **utcReference** `integer`
>
> UTC time reference in Unix time (seconds). Defaults to current time if omitted or invalid.
>
> #### 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] Tor Exit Nodes Geolocated API
>
> **Slug:** `BIG_DATA_CLOUD_TOR_EXIT_NODES_GEOLOCATED_API`
>
> Retrieve a paginated list of active TOR exit node IP addresses with geolocation and carrier (ASN) details. Use this tool to: - Get a list of known TOR exit node IPs to detect/block anonymous traffic - Analyze geographic distribution of TOR exit nodes by country - Look up carrier/ASN information for TOR nodes - Build IP blocklists or allowlists for TOR traffic Returns nodes with IP address, country info (when available), and detailed carrier/ASN data including BGP prefix counts and global ranking.
>
> #### Input Parameters
>
> **sort** `string ("ip" | "countryCode" | "countryName" | "carriers")`
>
> Field to sort results by: 'ip' (IP address), 'countryCode' (2-letter country code), 'countryName' (localized country name), or 'carriers' (carrier info).
>
> **order** `string ("asc" | "desc")`
>
> Sort order: 'asc' for ascending (A-Z, lowest-highest) or 'desc' for descending (Z-A, highest-lowest).
>
> **offset** `integer`
>
> Number of entries to skip for pagination. Use with batchSize to iterate through all nodes.
>
> **batchSize** `integer`
>
> Number of TOR exit node entries to return per request (1-1000). Use smaller values for quick checks, larger for bulk analysis.
>
> **localityLanguage** `string`
>
> ISO 639-1 language code for localized country names (e.g., 'en' for English, 'de' for German, 'fr' for French, 'ja' for Japanese).
>
> #### 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] User Agent Parser API
>
> **Slug:** `BIG_DATA_CLOUD_USER_AGENT_PARSER_API`
>
> Tool to parse a User-Agent string into device, OS, browser, and bot details. Use when you have a raw User-Agent header and need structured client info.
>
> #### Input Parameters
>
> **userAgentRaw** `string` *required*
>
> Raw User-Agent string to parse (from HTTP request header).
>
> #### 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] User Risk API
>
> **Slug:** `BIG_DATA_CLOUD_USER_RISK_API`
>
> Tool to return a risk assessment for a user based on IP signals for fraud prevention. Use after initial IP checks to decide whether to bypass or require captcha challenges.
>
> #### Input Parameters
>
> **ip** `string`
>
> IPv4 or IPv6 address to assess. If omitted, defaults to the caller's IP 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
