Geolocation

Big data cloud

Learn how to use Big data cloud with Composio

Overview

SLUG: BIG_DATA_CLOUD

Description

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

Authentication Details

generic_api_key
stringRequired

Connecting to Big data cloud

Create an auth config

Use the dashboard to create an auth config for the Big data cloud toolkit. This allows you to connect multiple Big data cloud accounts to Composio for agents to use.

1

Select App

Navigate to the [Big data cloud toolkit page](https://app.composio.dev/apps/Big data cloud) and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2from composio.types import auth_scheme
3
4# Replace these with your actual values
5big_data_cloud_auth_config_id = "ac_YOUR_BIG_DATA_CLOUD_CONFIG_ID" # Auth config ID created above
6user_id = "0000-0000-0000"  # UUID from database/app
7
8composio = Composio()
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11    # Replace this with a method to retrieve an API key from the user.
12    # Or supply your own.
13    user_api_key = input("[!] Enter API key")
14
15    connection_request = composio.connected_accounts.initiate(
16        user_id=user_id,
17        auth_config_id=auth_config_id,
18        config={"auth_scheme": "API_KEY", "val": user_api_key}
19    )
20
21    # API Key authentication is immediate - no redirect needed
22    print(f"Successfully connected Big data cloud for user {user_id}")
23    print(f"Connection status: {connection_request.status}")
24    
25    return connection_request.id
26
27
28connection_id = authenticate_toolkit(user_id, big_data_cloud_auth_config_id)
29
30# You can verify the connection using:
31connected_account = composio.connected_accounts.get(connection_id)
32print(f"Connected account: {connected_account}")

Tools

Executing tools

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["BIG_DATA_CLOUD"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Am I Roaming API

Description

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.

Action Parameters

latitude
numberRequired
longitude
numberRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: ASN Extended Receiving From Info API

Description

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.

Action Parameters

asn
stringRequired
batchSize
integerRequired
localityLanguage
stringDefaults to en
offset
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: ASN Extended Transit To Info API

Description

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.

Action Parameters

asn
stringRequired
batchSize
integerRequired
localityLanguage
stringDefaults to en
offset
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: ASN Rank List API

Description

Tool to fetch a ranked list of autonomous systems by ipv4 announcement volumes. use after you need to compare or analyze as ranks.

Action Parameters

batchSize
integerDefaults to 10
localityLanguage
stringDefaults to en
offset
integer
order
stringDefaults to asc
sort
stringDefaults to rank

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: BGP Active Prefixes API

Description

Tool to retrieve ipv4 or ipv6 prefixes currently announced on bgp. use when inspecting bgp routing announcements for a given asn.

Action Parameters

asn
stringRequired
batchSize
integerDefaults to 10
bogonsOnly
boolean
isv4
booleanDefaults to True
localityLanguage
stringDefaults to en
offset
integer
order
stringDefaults to asc
sort
stringDefaults to bgpPrefixNetworkAddress

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Reverse Geocoding With Timezone API

Description

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.

Action Parameters

latitude
numberRequired
localityLanguage
stringDefaults to en
longitude
numberRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Country by IP Address API

Description

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.

Action Parameters

ip
string
localityLanguage
stringDefaults to en

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Country Info API

Description

Tool to fetch detailed country information by iso code. use when you need localized names, currencies, regions, and other metadata for a country.

Action Parameters

code
stringRequired
localityLanguage
stringDefaults to en

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Email Address Verification API

Description

Tool to verify email addresses for syntax, domain validity, and disposability. use after obtaining the email input.

Action Parameters

emailAddress
Required

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Hazard Report API

Description

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

Action Parameters

ip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Networks by CIDR

Description

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.

Action Parameters

bogonsOnly
boolean
cidr
stringRequired
depthLimit
integerDefaults to 1
localityLanguage
stringDefaults to en
subnetsBatchSize
integerDefaults to 20
subnetsOffset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Network by IP Address API

Description

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.

Action Parameters

ip
string
localityLanguage
stringDefaults to en

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Phone Number Validation by IP

Description

Tool to validate phone numbers by inferring country from client ip. use when you want to validate a number without specifying country.

Action Parameters

ip
string
localityLanguage
stringDefaults to en
number
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Time Zone by IP Address API

Description

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.

Action Parameters

ip
string
utcReference
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Tor Exit Nodes Geolocated API

Description

Tool to list active tor exit nodes geolocated by country with carrier info. use when you need to detect or filter anonymous exit node traffic on your site.

Action Parameters

batchSize
integerDefaults to 10
localityLanguage
Defaults to en
offset
integer
order
stringDefaults to asc
sort
stringDefaults to ip

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: User Agent Parser API

Description

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.

Action Parameters

userAgentRaw
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: User Risk API

Description

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.

Action Parameters

ip
string

Action Response

data
objectRequired
error
string
successful
booleanRequired