Ipdata co | Composio Docs

Overview

SLUG: IPDATA_CO

Description

ipdata provides a simple HTTP-based API that allows you to look up the location, ownership, and threat profile of any IP address.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Ipdata co

Create an auth config

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

Select App

Navigate to [Ipdata co](https://platform.composio.dev?next_page=/marketplace/Ipdata co).

Configure Auth Config Settings

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

Create and Get auth config ID

Click “Create Ipdata co Auth Config”. 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

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

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Ipdata co toolkit’s playground](https://app.composio.dev/app/Ipdata co)

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["IPDATA_CO"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def 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 
33 invoke_llm()

Tool List

IPDATA_CO_ADVANCED_ASN_LOOKUP

Tool Name: Advanced ASN Lookup

Description

Tool to perform advanced ASN lookup returning prefixes, peers, and registry details. Use after confirming ASN number when detailed ASN info is required.

Action Parameters

asn

integerRequired

fields

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_CARRIER_FOR_IP

Tool Name: Get Carrier Data for an IP

Description

Tool to return mobile carrier data for a specific IP. Use when you need carrier name, MCC, and MNC for an IP address.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_EU_LOOKUP_SPECIFIC_IP

Tool Name: EU-specific IP lookup

Description

Tool to lookup a specific IP address via the EU-only data residency endpoint. Use when you need IP lookup processed and stored within the EU.

Action Parameters

callback

string

fields

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_CALLING_CODE

Tool Name: IPData: Calling Code

Description

Tool to fetch the international calling_code for an IP's country. Use when you need only the calling code field from ipdata_co.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_CARRIER

Tool Name: IPDATA Field Carrier

Description

Tool to return only the carrier object for the calling IP. Use when you need mobile carrier details of a specific IP.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_CITY

Tool Name: Get City from IP

Description

Tool to return only city for an IP. Use when only the city name is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_CONTINENT_CODE

Tool Name: IPData: Continent Code

Description

Tool to return only continent_code for an IP. Use when only the continent code is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_CONTINENT_NAME

Tool Name: Get Continent Name from IP

Description

Tool to return only continent name for an IP. Use when only the continent name is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_COUNT

Tool Name: IPDATA Field Count

Description

Tool to return only the request count made by your API key in the last 24 hours. Use when monitoring your API usage and you only need the total count.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_COUNTRY_CODE

Tool Name: IPData: Country Code

Description

Tool to return only country_code for an IP. Use when only the 2-letter country code is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_COUNTRY_NAME

Tool Name: Get Country Name from IP

Description

Tool to return only country name for an IP. Use when only the country name is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_CURRENCY

Tool Name: IPDATA Field Currency

Description

Tool to return only currency object for an IP. Use when currency details are needed.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_EMOJI_FLAG

Tool Name: Get Emoji Flag from IP

Description

Tool to return only emoji flag for an IP. Use when only the country flag emoji is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_EMOJI_UNICODE

Tool Name: Get Emoji Unicode from IP

Description

Tool to return only emoji_unicode for an IP. Use when only the Unicode country flag emoji is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_IP

Tool Name: IPData: IP

Description

Tool to return only the caller’s IP string. Use when you need just the origin IP of your request.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_IS_EU

Tool Name: IPData: Is EU

Description

Tool to return only is_eu for an IP. Use when you need to determine if an IP's country belongs to the EU.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_LANGUAGES

Tool Name: IPData: Languages

Description

Tool to return only the languages array for an IP. Use when only language details for an IP are required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_LATITUDE

Tool Name: IPData: Latitude

Description

Tool to return only the latitude for an IP. Use when only the latitude coordinate is needed.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_LONGITUDE

Tool Name: Get Longitude from IP

Description

Tool to return only longitude for an IP. Use when only the longitude value is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_POSTAL

Tool Name: IPData: Postal Code

Description

Tool to return only postal code for an IP. Use when only the postal code (ZIP/postcode) is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_REGION

Tool Name: Get Region from IP

Description

Tool to return only region for an IP. Use when only the region name is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_REGION_CODE

Tool Name: IPData: Region Code

Description

Tool to return only region_code for an IP. Use when only the ISO 3166-2 region code is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_THREAT

Tool Name: Get Threat for IP

Description

Tool to return only the threat object for the calling IP. Use when only the threat details are required for the current IP.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_FIELD_TIME_ZONE

Tool Name: IPData: Time Zone

Description

Tool to return only the time_zone object for an IP. Use when only timezone data is required.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_GET_CURRENCY_FOR_IP

Tool Name: Get Currency for IP

Description

Tool to retrieve currency information for a specific IP. Use when you need currency details based on the geolocation of an IP address.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IP_DATA_BASIC_ASN_FOR_IP

Tool Name: IPData Basic ASN for IP

Description

Tool to return basic ASN data for a specific IP. Use when you need ASN number, organization, domain, route, and type details.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IPDATA_BULK_LOOKUP_V1

Tool Name: IPData Bulk Lookup V1

Description

Tool to bulk lookup up to 100 IP addresses via ipdata.co. Use when you have multiple IPs and need geolocation and threat data in one call.

Action Parameters

ips

arrayRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IP_DATA_COMPANY_FOR_IP

Tool Name: Get company data for IP

Description

Tool to retrieve company data for a given IP address. Use when you need the organization name, domain, network prefix, and usage type for an IPv4 or IPv6.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IPDATA_EU_LOOKUP_CALLING_IP

Tool Name: EU-only calling IP lookup

Description

Tool to lookup the calling client IP via EU-residency endpoint. Use when you need IP data processed and stored within EU.

Action Parameters

callback

string

fields

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IP_DATA_LOOKUP_IP_V1

Tool Name: IPData Lookup IP V1

Description

Tool to lookup comprehensive IP information (geolocation, network, company, and threat data) in one call. Use when you need all IP insights together.

Action Parameters

callback

string

fields

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IP_DATA_THREAT_FOR_IP

Tool Name: IPData Threat for IP

Description

Tool to return threat intelligence data for a specific IP. Use when you need to determine if an IP is a Tor node, VPN, proxy, datacenter, threat actor, or listed on blocklists.

Action Parameters

callback

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_IP_DATA_TIME_ZONE_FOR_IP

Tool Name: IPData Time Zone for IP

Description

Tool to return timezone data for a specific IP. Use when you need timezone details, including name, abbreviation, offset, DST status, and local current time for an IP.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

IPDATA_CO_LOOKUP_CALLING_IP

Tool Name: Lookup Calling IP

Description

Tool to lookup full data for the calling client IP. Use when you need geolocation, network, and threat intelligence for the current IP.

Action Parameters

callback

string

fields

string

Action Response

data

objectRequired

error

string

successful

booleanRequired