Interzoid

Learn how to use Interzoid with Composio

Overview

SLUG: INTERZOID

Description

Interzoid offers APIs for data matching, verification, and enrichment, allowing developers to improve data quality and integrate real-time insights into applications

Authentication Details

generic_api_key
stringRequired

Connecting to Interzoid

Create an auth config

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

1

Select App

Navigate to Interzoid.

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 Interzoid 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

1from composio import Composio
2
3# Replace these with your actual values
4interzoid_auth_config_id = "ac_YOUR_INTERZOID_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def 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 Interzoid for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, interzoid_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Interzoid toolkit’s playground

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=["INTERZOID"])
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: Parse Address

Description

Tool to parse a free-form address into structured components. Use when you need to extract street, city, state, etc. from unstructured address strings.

Action Parameters

address
stringRequired
license
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Interzoid Email Trust Score

Description

Tool to return a trust score for an email address. Use when you need to assess the quality and legitimacy of an email address. Call after acquiring the target email.

Action Parameters

license
stringRequired
lookup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Address Match Advanced

Description

Tool to generate a similarity key for a US street address. Use when performing fuzzy deduplication of addresses across datasets.

Action Parameters

address
stringRequired
algorithm
stringRequired
license
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Business Info

Description

Tool to retrieve comprehensive company profiles and business intelligence. Use when you need detailed company information by name, domain, or email.

Action Parameters

license
string
lookup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Company Match Advanced

Description

Tool to generate a fuzzy-matching key for an organization name. Use when normalizing and deduplicating company names after extraction.

Action Parameters

algorithm
stringRequired
company
stringRequired
license
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Country Info

Description

Tool to standardize a country name and return metadata like ISO codes, currency, TLD, and calling code. Use when you need detailed country information based on a country name or code.

Action Parameters

algorithm
stringRequired
country
stringRequired
license
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Currency Rate

Description

Tool to retrieve live USD exchange rate for a currency symbol. Use when you need current market rate for a three-letter ISO 4217 currency.

Action Parameters

license
string
symbol
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Custom Data

Description

Tool to retrieve custom enriched data based on a topic and lookup value. Use after specifying the desired output fields.

Action Parameters

license
string
lookup
stringRequired
model
string
output
arrayRequired
topic
stringRequired
x_api_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Email Info

Description

Tool to validate an email and return enrichment/demographics. Use when in-depth email analysis is required after confirming the email address.

Action Parameters

email
stringRequired
license
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Entity Type

Description

Tool to classify a text string into an entity type. Use when you need to identify if input refers to a Location, Organization, or Individual.

Action Parameters

license
string
text
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Executive Profile

Description

Tool to retrieve executive profile details based on company and title keywords. Use when you need executive information such as LinkedIn and biography links.

Action Parameters

license
string
lookup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Full Name Match

Description

Tool to generate a similarity key for a full name. Use when performing fuzzy matching or deduplication of individual names.

Action Parameters

fullname
stringRequired
license
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Full Name Match Score

Description

Tool to return a similarity score between two full names. Use when determining if two person names likely refer to the same individual.

Action Parameters

fullname1
stringRequired
fullname2
stringRequired
license
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Global Address Match

Description

Tool to generate a similarity key for a global address. Use when performing fuzzy matching and deduplication of international addresses.

Action Parameters

address
stringRequired
algorithm
stringRequired
license
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Global Page Load Performance

Description

Tool to measure page/API load time from a specified global origin. Use when benchmarking response times across geographic locations.

Action Parameters

license
stringRequired
origin
stringRequired
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Global Weather

Description

Tool to return current weather conditions for a global location. Use when you need up-to-the-minute weather details for any city worldwide.

Action Parameters

license
stringRequired
location
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get IP Profile

Description

Tool to retrieve IP intelligence including ASN, organization, geolocation, and reputation. Use when profiling an IP address for threat analysis.

Action Parameters

license
string
lookup
stringRequired
x-api-key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get API License Key

Description

Tool to retrieve the configured Interzoid API license key. Use when you need to inspect which API key is active in the current connection.

Action Parameters

authorization
string
license
string
query_license
string
x_api_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Name Origin

Description

Tool to infer the likely country or region of origin from a personal name. Use after obtaining a name to guess its origin.

Action Parameters

license
string
name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Org Match Score

Description

Tool to return a 1–99 match score between two organization names. Use after gathering both names to evaluate organization similarity.

Action Parameters

company1
stringRequired
company2
stringRequired
license
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Org Standard

Description

Tool to standardize an organization name to a canonical English form. Use when you need consistent company naming for data normalization.

Action Parameters

license
string
org
stringRequired
x-api-key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Parent Company Info

Description

Tool to retrieve ultimate parent company information. Use when you have a company name or domain and need its ownership details.

Action Parameters

license
string
lookup
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Phone Number Profile

Description

Tool to retrieve phone number intelligence including validation, normalization, carrier, and risk assessment. Use when you need to enrich and validate a phone number after capture.

Action Parameters

license
string
lookup
stringRequired
x-api-key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Product Match

Description

Tool to generate a similarity key for a product name. Use when normalizing and fuzzy-matching names across catalogs.

Action Parameters

algorithm
stringRequired
license
string
product
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Remaining API Credits

Description

Tool to retrieve remaining Interzoid API credits. Use when you need to check your credit balance after usage.

Action Parameters

license
string
x_api_key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Weather by ZIP Code

Description

Tool to get current weather conditions for a US ZIP code. Use when you need real-time weather information for a specific area after confirming the ZIP code is valid.

Action Parameters

license
string
zip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Identify Language

Description

Tool to detect the language of a text string. Use when you need to identify the language of arbitrary text. Call after obtaining the text input.

Action Parameters

license
stringRequired
text
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Translate any text (auto-detect language)

Description

Tool to auto-detect the input language and translate given text to the specified target language. Use when you need quick translations without specifying the source language.

Action Parameters

license
stringRequired
text
stringRequired
to
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired