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

# Prospeo

Prospeo provides B2B person and company search, enrichment, and verified contact data through its REST API.

- **Category:** people & contact data
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `PROSPEO`
- **Version:** 20261014_02
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Bulk Enrich Companies

**Slug:** `PROSPEO_BULK_ENRICH_COMPANIES`

Match 1-50 companies and correlate outcomes by caller-generated identifier. Costs 1 credit per match; no match and repeats within 90 days are free. Submit at most 50 records per request; rate limits depend on your plan.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.024 per matched company; each match costs 1 credit, and repeats may be free

**Discount:** 19

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `companies` | array | Yes | Companies to match. Each item requires a unique caller-generated alphanumeric identifier and at least one matching field. Submit 1-50 records. |

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

### Bulk Enrich People

**Slug:** `PROSPEO_BULK_ENRICH_PEOPLE`

Match 1-50 people and correlate every outcome by a caller-generated identifier. Each email found costs 1 credit; each requested and found mobile costs 10 credits and includes email enrichment. No match and repeat enrichment within 90 days are free. Submit at most 50 records; rate limits depend on your plan.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.024 per found email; $0.245 per found mobile including email; repeats may be free

**Discount:** 19

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `people` | array | Yes | People to match (1-50). Each record needs a unique caller correlation identifier and must satisfy one documented person-match minimum. |
| `enrich_mobile` | boolean | No | Request mobile enrichment for every record. WARNING: each found mobile costs 10 credits and also includes email enrichment. |
| `only_verified_email` | boolean | No | Return only records with an email Prospeo marks verified. |
| `only_verified_mobile` | boolean | No | Return only records with a verified mobile. Setting true enables enrich_mobile and may cost 10 credits per found mobile. |

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

**Slug:** `PROSPEO_ENRICH_COMPANY`

Match one company and return its full profile. Costs 1 credit when matched; no match and repeat enrichment within 90 days are free. Rate limits depend on your plan.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.024 per matched company; each match costs 1 credit, and repeats may be free

**Discount:** 19

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company` | object | Yes | Typed company matching datapoints; at least one matching field is required. |

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

**Slug:** `PROSPEO_ENRICH_PERSON`

Match one person and return profile, company, and available contact data. An email found costs 1 credit. Requesting and finding mobile costs 10 credits and also includes email enrichment. No match and repeat enrichment within 90 days are free. Rate limits depend on your plan.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.024 per found email; $0.245 per found mobile including email; repeats may be free

**Discount:** 19

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person` | object | Yes | Person matching datapoints. More datapoints generally improve matching. |
| `enrich_mobile` | boolean | No | Request mobile enrichment. WARNING: a found mobile costs 10 credits and also includes email enrichment. |
| `only_verified_email` | boolean | No | Return a record only when it has an email Prospeo marks verified. |
| `only_verified_mobile` | boolean | No | Return a record only when it has a verified mobile. Setting true enables enrich_mobile; a found mobile may therefore cost 10 credits. |

#### 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 Account Information

**Slug:** `PROSPEO_GET_ACCOUNT_INFORMATION`

Return the connected Prospeo team's plan, remaining and used credits, team size, and quota-renewal date. This free endpoint is the recommended preflight before credit-consuming search or enrichment.

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

**Slug:** `PROSPEO_SEARCH_COMPANIES`

Search Prospeo's company database with typed practical and advanced filters. Returns one page of at most 25 companies. Each non-empty page costs 1 credit unless the team paid for the identical page within 30 days. Rate limits depend on your plan. Filters labeled STARTER+, GROWTH+, or PRO+ return PLAN_REQUIRED on lower plans.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.024 per billed search pages; each page costs 1 credit, and empty or repeat pages may be free

**Discount:** 19

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Typed company filters. Required on the first page and restored automatically from next_cursor on continuation pages. |
| `next_cursor` | string | No | Opaque cursor from a prior response. Omit for page one; when provided, omit filters because the cursor restores them. |

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

**Slug:** `PROSPEO_SEARCH_PEOPLE`

Search Prospeo's person database with typed person and company filters. Returns profiles and contact availability but never reveals email or mobile values. Each non-empty page costs 1 credit unless the team paid for the identical page within 30 days. Returns one page of at most 25 results. Rate limits depend on your plan. Filters labeled STARTER+, GROWTH+, or PRO+ return PLAN_REQUIRED on lower plans.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.024 per billed search pages; each page costs 1 credit, and empty or repeat pages may be free

**Discount:** 19

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | No | Typed person and company filters. Required on the first page and restored automatically from next_cursor on continuation pages. At least one positive filter is required. Dashboard-only persona_ids, company_list_oids, and temp_matching_oids are not supported. |
| `next_cursor` | string | No | Opaque cursor from a prior response. Omit for page one; when provided, omit filters because the cursor restores them and advances one 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 |

### Search Filter Suggestions

**Slug:** `PROSPEO_SEARCH_SUGGESTIONS`

Resolve canonical Prospeo filter values for locations, titles, technologies, industries, codes, and advanced company fields. Free and consumes no credits. Send exactly one suggestion type. Rate limit: 15 requests/second on all plans.

**Instant:** Supported on the latest version.

**Instant pricing:** $0 per request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Search text, at least 2 characters. |
| `suggestion_type` | string ("location" | "job_title" | "technology" | "industry" | "naics" | "sic" | "company_operating_languages" | "company_google_discovery" | "company_key_customers" | "company_integrations" | "company_products_services_products" | "company_products_services_services" | "company_icp_titles" | "company_icp_industries" | "company_icp_geographic_markets" | "company_icp_other_departments" | "company_awards" | "company_awards_compliance" | "company_headcount_by_location" | "company_funding_investors" | "company_funding_accelerator" | "company_website_traffic_countries") | Yes | Canonical value category to resolve. The action sends exactly one matching provider search 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 |