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

# Coresignal

Coresignal provides agentic search and real-time employee data from public web sources for research, recruiting, and sales workflows.

- **Category:** ai web scraping
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `CORESIGNAL`
- **Version:** 00000000_00

## Tools

### Get Real-Time Employee Profile

**Slug:** `CORESIGNAL_GET_REAL_TIME_EMPLOYEE_PROFILE`

Retrieve an employee profile, using cached data up to max_age hours old (24 by default); set max_age=0 to request current data. Requires the connected account's separate Real-time Employee API entitlement and may take up to 30 seconds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Public professional-network profile URL for the employee to retrieve. |
| `max_age` | number | No | Maximum acceptable cached profile age in hours; use 0 to request current data, 24 for one day, or 168 for one week. |

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

### Fast Search

**Slug:** `CORESIGNAL_SEARCH_FAST`

Turn a natural-language employee, company, or job search into an Elasticsearch query, or return matching preview records. Prefer this lower-cost search unless deeper reasoning or clarification is needed; each call consumes Coresignal credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum preview records to return in data mode (1-20). |
| `entity` | string ("employee" | "company" | "job") | No | Entity type to search. |
| `prompt` | string | Yes | Natural-language description of the employees, companies, or jobs to find. |
| `threshold` | number | No | Matching threshold from 0 to 1; lower values may broaden the results. |
| `return_data` | boolean | No | Return preview records when true; otherwise return the generated Elasticsearch query and sort. |

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

**Slug:** `CORESIGNAL_SEARCH_WITH_REASONING`

Run a higher-cost natural-language search that explains its interpretation and can request clarification. Use when fast search is ambiguous or reasoning is valuable; a query-mode call consumed 100 trial credits in testing, data-mode cost varies, clarification requests do not consume credits, and the endpoint is limited to 10 requests per hour.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum preview records to return in data mode (1-20). |
| `prompt` | string | Yes | Natural-language search request, or the answer to a clarification requested in this session. |
| `threshold` | number | No | Matching threshold from 0 to 1; lower values may broaden the results. |
| `session_id` | string | Yes | Caller-generated UUIDv4; reuse it when continuing a clarification exchange. |
| `return_data` | boolean | No | Return preview records when true; otherwise return the reasoned Elasticsearch query. |
| `allow_clarification` | boolean | No | Allow Coresignal to ask for clarification instead of forcing an immediate search result. |

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