---
canonical_url: "https://docs.composio.dev/toolkits/explorium"
markdown_url: "https://docs.composio.dev/toolkits/explorium.md"
product: "platform"
version: null
last_updated: null
---

# Explorium

Explorium AgentSource provides company and prospect discovery, matching, enrichment, research, and usage management through its REST API.

- **Category:** ai sales tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `EXPLORIUM`
- **Version:** 00000000_00

## Tools

### Autocomplete Filter Values

**Slug:** `EXPLORIUM_AUTOCOMPLETE_FILTER_VALUES`

Find normalized values for Explorium business and prospect search filters, including company names, job titles, industries, locations, skills, and interests. Live trial calls consumed zero credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field` | string ("country" | "country_code" | "region_country_code" | "google_category" | "naics_category" | "linkedin_category" | "company_tech_stack_tech" | "company_tech_stack_categories" | "job_title" | "company_size" | "company_revenue" | "number_of_locations" | "company_age" | "job_department" | "job_level" | "city_region_country" | "company_name" | "business_intent_topics" | "city_region" | "skills" | "interests") | Yes | Filter field whose accepted values to search. |
| `query` | string | No | Optional text prefix or phrase to match; omit to browse values where supported. |
| `semantic_search` | boolean | No | Enable semantic rather than lexical matching when supported by the selected field. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enrich Business Firmographics

**Slug:** `EXPLORIUM_ENRICH_BUSINESS_FIRMOGRAPHICS`

Enrich 1-50 Explorium business IDs with company firmographics. This call is credit-metered: a live trial probe charged exactly one credit for one submitted business. Check EXPLORIUM_GET_CREDIT_BALANCE first; the response reports the actual credit usage for the call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `business_ids` | array | Yes | One to 50 lowercase 32-character hexadecimal Explorium business IDs. This enrichment is credit-metered; a live trial request consumed one credit for one submitted business. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Audience Stats

**Slug:** `EXPLORIUM_GET_AUDIENCE_STATS`

Return aggregate distributions and total counts for either a business or prospect filter set before fetching records. Empty business filters were live-tested at zero credits; usage is still reported.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_type` | string ("business" | "prospect") | Yes | Whether to summarize businesses or prospects; selects the matching stats endpoint. |
| `business_filters` | object | No | Required for entity_type='business'. Pass an empty object for all businesses. |
| `prospect_filters` | object | No | Required for entity_type='prospect'. Pass an empty object for all prospects. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credit Balance

**Slug:** `EXPLORIUM_GET_CREDIT_BALANCE`

Return the connected Explorium company's allocated and remaining credits and trial or paid account type. Use before full searches, enrichments, or other potentially metered calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Status

**Slug:** `EXPLORIUM_GET_JOB_STATUS`

Get detailed status, timing, credit usage, errors, and downloadable CSV result metadata for one existing Explorium job. Invalid IDs may produce a provider 500 instead of 404.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Job ID returned by EXPLORIUM_LIST_JOBS or an Explorium job-submission workflow. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Jobs

**Slug:** `EXPLORIUM_LIST_JOBS`

List existing Explorium asynchronous jobs, optionally filtered by lifecycle status, and return their IDs for detailed monitoring. This does not create or cancel jobs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `skip` | integer | No | Zero-based number of jobs to skip. The provider exposes no page-size or continuation parameter. |
| `status` | string ("queued" | "running" | "succeeded" | "failed" | "cancelled" | "expired") | No | Optional lifecycle status filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Match Businesses

**Slug:** `EXPLORIUM_MATCH_BUSINESSES`

Resolve 1-50 business names, domains, URLs, or LinkedIn URLs to Explorium business IDs while preserving input order. The provider reports credit usage for every call; a one-record trial call consumed zero credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `businesses` | array | Yes | One to 50 businesses to resolve. Each item must include at least one non-empty name, domain, website URL, or LinkedIn company URL. Input order is preserved in the matches. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Match Prospects

**Slug:** `EXPLORIUM_MATCH_PROSPECTS`

Resolve 1-50 people from names, employers, email, phone, LinkedIn URL, or Explorium business ID to prospect IDs while preserving input order. A live one-record trial call used zero credits; returned usage is included.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prospects` | array | Yes | People to resolve, in input order. Each item must contain at least one nonblank name, employer, email, phone number, LinkedIn URL, or business ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Businesses

**Slug:** `EXPLORIUM_SEARCH_BUSINESSES`

Search Explorium businesses with structured filters and cursor pagination. Preview mode is the zero-credit default observed on the trial account; full mode may consume credits, so check EXPLORIUM_GET_CREDIT_BALANCE first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("preview" | "full") | No | Use preview for minimal records and observed zero-credit browsing; full returns complete records and may consume credits. |
| `exclude` | array | No | Explorium business IDs to exclude, up to 1,000 lowercase 32-character hexadecimal IDs. |
| `filters` | object | No | Structured business filters. Use autocomplete to obtain normalized categorical values. |
| `page_size` | integer | No | Maximum businesses in this page (1-500). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call. Omit for the first page and repeat the same search inputs when continuing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Prospects

**Slug:** `EXPLORIUM_SEARCH_PROSPECTS`

Search Explorium prospects with strict person and employer filters, returning one cursor-paginated page. Preview is the zero-credit default observed on the trial account; full mode may consume credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("preview" | "full") | No | Use preview for minimal records; it consumed zero credits in a live trial call. Full mode may consume credits. |
| `exclude` | array | No | Prospect IDs to exclude, up to 1,000 lowercase 40-character hexadecimal IDs. |
| `filters` | object | No | Structured person and employer filters. Use autocomplete for normalized categorical values. |
| `page_size` | integer | No | Maximum prospects in this page (1-500). |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |