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

# DataForB2B

DataForB2B provides B2B people and company search, typeahead, and enrichment data for sales and recruiting workflows.

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

## Tools

### Add Monitor Targets

**Slug:** `DATAFORB2B_ADD_MONITOR_TARGETS`

Add watched values or structured targets to an existing monitor. Confirm the monitor and target set before changing it. A JSON request body is required, but the documented schema permits an empty object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watch` | string | No | Provider-defined JSON value or values to add to the watch set. |
| `values` | array | No | String values to add to the monitor's watch set. |
| `targets` | array | No | Structured targets to add to the monitor. |
| `monitor_id` | integer | Yes | Numeric ID of the monitor to update. |

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

**Slug:** `DATAFORB2B_BULK_ENRICH_PROFILES_CURRENT`

Bulk-enrich one to 100 profiles through the current unversioned V2 engine. Successful enrichments use the same per-field record and contact-credit costs as single-profile enrichment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enrich_phone` | boolean | No | Request mobile numbers. Warning: costs $0.15 in contact credits per number found. |
| `enrich_github` | boolean | No | Request matched GitHub profile data for free. |
| `enrich_profile` | boolean | No | Request full profile details for 1 record per profile. |
| `enrich_work_email` | boolean | No | Request professional emails for 1 record per email found. |
| `profile_identifiers` | array | Yes | One to 100 LinkedIn profile URLs, public IDs, member identities, or encoded prof_ IDs. |
| `enrich_personal_email` | boolean | No | Request personal emails. Warning: costs $0.03 in contact credits per email found. |

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

**Slug:** `DATAFORB2B_BULK_ENRICH_PROFILES_V1`

Bulk-enrich one to 100 profiles through the exact V1/DECO route. Credits are debited only for successful enrichments at the same per-field costs as single-profile enrichment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enrich_phone` | boolean | No | Request mobile numbers. Warning: costs $0.15 in contact credits per number found. |
| `enrich_github` | boolean | No | Request matched GitHub profile data for free. |
| `enrich_profile` | boolean | No | Request full profile details for 1 record per profile. |
| `enrich_work_email` | boolean | No | Request professional emails for 1 record per email found. |
| `profile_identifiers` | array | Yes | One to 100 LinkedIn profile URLs, public IDs, member identities, URNs, or encoded prof_ IDs. |
| `enrich_personal_email` | boolean | No | Request personal emails. Warning: costs $0.03 in contact credits per email found. |

#### 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 Profiles V2 Alias

**Slug:** `DATAFORB2B_BULK_ENRICH_PROFILES_V2_ALIAS`

Bulk-enrich one to 100 profiles through the explicit V2 alias. It has the same request, response, and per-field costs as the current bulk V2 route.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enrich_phone` | boolean | No | Request mobile numbers. Warning: costs $0.15 in contact credits per number found. |
| `enrich_github` | boolean | No | Request matched GitHub profile data for free. |
| `enrich_profile` | boolean | No | Request full profile details for 1 record per profile. |
| `enrich_work_email` | boolean | No | Request professional emails for 1 record per email found. |
| `profile_identifiers` | array | Yes | One to 100 LinkedIn profile URLs, public IDs, member identities, or encoded prof_ IDs. |
| `enrich_personal_email` | boolean | No | Request personal emails. Warning: costs $0.03 in contact credits per email found. |

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

### Count Search Results

**Slug:** `DATAFORB2B_COUNT_SEARCH_RESULTS`

Count people or companies matching structured filters with up to three group levels, without returning records. This read-like POST is free, consumes no records, and does not change provider state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filters` | object | Yes | Structured filters with up to three group levels, shaped as {op, conditions}, where op is and, or, or not. Each condition is {column, type, value?, value2?}; type is =, !=, >, >=, <, <=, in, not_in, like, not_like, is_null, is_not_null, between, or regex. Use a non-empty array value for in/not_in and omit value only for is_null/is_not_null. Provide value2 for between, or as the 1-300 km radius with = on profile_location_radius or current_job_location_radius; omit it otherwise. |
| `category` | string ("people" | "company" | "companies") | Yes | Resource category to count: people for professional profiles, or company/companies for organizations. |

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

### Create Checkout URL

**Slug:** `DATAFORB2B_CREATE_CHECKOUT_URL`

PAYMENT SAFETY: returns a Stripe Checkout URL for an explicit product. Treat the returned URL as a payment link. Never automatically open, follow, or complete it; require the user to confirm before continuing to Stripe.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product` | string | Yes | DataForB2B product value for which to return a Stripe Checkout URL. |

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

### Create Monitor

**Slug:** `DATAFORB2B_CREATE_MONITOR`

Create a monitor that subscribes to a signal and optionally watches one or more values. Use only a controlled callback URL and manage the optional verification secret as sensitive data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Controlled callback URL where DataForB2B may deliver monitor events. |
| `watch` | string | No | Provider-defined JSON value or values to watch. |
| `signal` | string | Yes | Signal identifier from List Signals. |
| `target` | object | No | Optional single structured monitor target. |
| `filters` | object | No | Optional provider-defined signal filters. |
| `targets` | array | No | Optional structured monitor targets. |
| `callback_signature_value` | string | No | Optional value DataForB2B uses to sign callback deliveries. Treat this input as sensitive. |

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

### Delete Monitor

**Slug:** `DATAFORB2B_DELETE_MONITOR`

Delete one monitor. This is a destructive operation; confirm the exact monitor ID before calling it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `monitor_id` | integer | Yes | Exact numeric ID of the monitor to delete. |

#### 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:** `DATAFORB2B_ENRICH_COMPANY`

Read complete firmographic data for one known company. This read-like POST does not change provider state but consumes records; it cost 1 record in probing, and credits_used reports the actual charge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_identifier` | string | Yes | Company LinkedIn slug or URL, encoded org_ ID, or Twitter/X URL or handle. |

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

**Slug:** `DATAFORB2B_ENRICH_PROFILE`

Read a fuller professional profile, optional work email, or GitHub profile for one known person. This read-like request consumes records and returns credits_used; full-profile-only enrichment cost 1 record in probing. Personal email and phone enrichment are intentionally unavailable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_domain` | string | No | Known employer domain to improve work-email matching; omit when unknown. |
| `include_github` | boolean | No | Request a matched GitHub profile when available. This may add record cost; inspect credits_used. |
| `include_profile` | boolean | No | Return the full professional profile when explicitly enabled. Full-profile-only enrichment cost 1 record in probing, but credits_used is authoritative. |
| `include_work_email` | boolean | No | Request a professional work email when available. This may add record cost; inspect credits_used. This never requests a personal email. |
| `profile_identifier` | string | Yes | LinkedIn URL or public ID, encoded prof_ ID, or Twitter/X URL or handle for the person. |

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

**Slug:** `DATAFORB2B_ENRICH_PROFILE_V1`

Enrich one profile through the exact V1/DECO route. Selected profile and work-email data consume records; personal email and phone consume contact credits only when found, and GitHub enrichment is free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `enrich_phone` | boolean | No | Request a mobile number. Warning: costs $0.15 in contact credits when found. |
| `enrich_github` | boolean | No | Request matched GitHub profile data for free. |
| `company_domain` | string | No | Known employer domain to try first for work-email matching. |
| `enrich_profile` | boolean | No | Request full profile details for 1 record per profile. |
| `enrich_work_email` | boolean | No | Request a professional email for 1 record per email found. |
| `profile_identifier` | string | Yes | One LinkedIn URL, public ID, member identity, URN, or encoded prof_ ID. |
| `enrich_personal_email` | boolean | No | Request a personal email. Warning: costs $0.03 in contact credits when found. |

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

### Extract Post Comments

**Slug:** `DATAFORB2B_EXTRACT_POST_COMMENTS`

Return one page of comments from a LinkedIn post. DataForB2B charges 1 record per 10 comments or fraction thereof.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Comments to return for 1 record per 10 comments or fraction thereof. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. |
| `offset` | integer | No | Zero-based comment offset for the first page. |
| `post_url` | string | Yes | LinkedIn post URL or supported post URN. |

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

### Extract Post Reactions

**Slug:** `DATAFORB2B_EXTRACT_POST_REACTIONS`

Return one page of reactions from a LinkedIn post. DataForB2B charges 1 record per 10 reactions or fraction thereof.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Reactions to return for 1 record per 10 reactions or fraction thereof. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. |
| `offset` | integer | No | Zero-based reaction offset for the first page. |
| `post_url` | string | Yes | LinkedIn post URL or supported post URN. |

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

### Extract Profile Comments

**Slug:** `DATAFORB2B_EXTRACT_PROFILE_COMMENTS`

Return one page of comments made by a LinkedIn profile. This social-data read costs 1 record per 10 comments or fraction thereof, and counts up to 1000 may trigger internal provider pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Comments to return for 1 record per 10 comments or fraction thereof. DataForB2B may paginate internally. |
| `pagination_token` | string | No | Continuation token from next_pagination_token; omit for the first page. |
| `profile_identifier` | string | Yes | LinkedIn URL, public ID, member identity, or encoded prof_ 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 |

### Extract Profile Posts

**Slug:** `DATAFORB2B_EXTRACT_PROFILE_POSTS`

Return one page of posts made by a LinkedIn profile. DataForB2B charges 1 record per 10 posts or fraction thereof; request only the needed count.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Posts to return for 1 record per 10 posts or fraction thereof. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. |
| `offset` | integer | No | Zero-based post offset for the first page. |
| `keyword` | string | No | Keyword filter for post content. |
| `sort_by` | string ("date_posted" | "relevance") | No | Sort order, documented as date_posted or relevance. |
| `post_type` | string ("ARTICLE" | "VIDEO" | "PHOTO" | "DOCUMENT") | No | Post type filter such as ARTICLE, VIDEO, PHOTO, or DOCUMENT. |
| `profile_identifier` | string | Yes | LinkedIn URL, public ID, member identity, or encoded prof_ 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 |

### Generate Search Filters

**Slug:** `DATAFORB2B_GENERATE_SEARCH_FILTERS`

Convert natural language into reusable DataForB2B filters without running the final record search. The official contract charges 1 credit per call; with_total additionally executes a count. This does not change provider state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Natural-language description to convert into search filters. |
| `verify` | boolean | No | Verify and repair generated filters against the index when needed. |
| `category` | string ("people" | "company" | "companies") | Yes | Category whose filter vocabulary should be used. Company and companies are equivalent; the provider wire uses company. |
| `with_total` | boolean | No | Also execute a count query. This adds provider work beyond filter generation. |
| `previous_query` | string | No | Previous incremental query; provide with previous_filters. |
| `previous_filters` | object | No | Prior simple_filters object; provide with previous_query. |
| `lookalike_use_case` | string ("sales" | "recruiter") | No | Intent when query contains a LinkedIn profile URL. |

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

**Slug:** `DATAFORB2B_GET_ACCOUNT`

Validate the connected API key and return the current record balance. When the provider includes cost metadata, preserve it in costs. This read is free and does not consume records or change provider state.

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

**Slug:** `DATAFORB2B_GET_COMPANIES_BATCH`

Fetch full stored company records for up to 1000 encoded company IDs. This read-like POST does not change provider state and may return a large dataset. The response is preserved because DataForB2B does not publish a response schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_ids` | array | Yes | Encoded org_ company IDs returned by DataForB2B company search. The provider permits an empty list; send only the IDs needed. |

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

**Slug:** `DATAFORB2B_GET_DATASET_STATS`

Read DataForB2B global dataset statistics.

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

**Slug:** `DATAFORB2B_GET_DETAILED_HEALTH`

Read the detailed DataForB2B API health-check response.

#### 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 Export By Date

**Slug:** `DATAFORB2B_GET_EXPORT_BY_DATE`

Get the DataForB2B daily export for a specific YYYY-MM-DD date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `export_date` | string | Yes | Exact daily export date in YYYY-MM-DD format. |

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

**Slug:** `DATAFORB2B_GET_LATEST_EXPORT`

Get the most recent completed DataForB2B daily export with a fresh two-day download link.

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

**Slug:** `DATAFORB2B_GET_PROFILES_BATCH`

Fetch full stored profile cards for 1 to 1000 encoded profile IDs. This read-like POST does not change provider state, but show_private_fields may expose sensitive profile data and a large batch may return a large dataset. The response is preserved because DataForB2B does not publish a response schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `profile_ids` | array | Yes | Encoded prof_ profile IDs returned by DataForB2B people search. Send only the IDs needed. |
| `show_private_fields` | boolean | No | Whether to include private profile fields such as flags, badges, and publications. Leave false unless this sensitive data 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 |

### Get Root Status

**Slug:** `DATAFORB2B_GET_ROOT_STATUS`

Read the DataForB2B API root health-check response.

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

**Slug:** `DATAFORB2B_GET_TYPEAHEAD_SUGGESTIONS`

Return canonical values and IDs for a people or company search filter. This read consumes 0.01 record per returned suggestion in the observed account and does not change provider state; credits_used reports the actual charge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum suggestions to return (1-20). Each returned suggestion may consume 0.01 record, so request only what is needed. |
| `query` | string | Yes | Text prefix or phrase to autocomplete. |
| `filter_type` | string ("company" | "people_industry" | "company_industry" | "category" | "location" | "city" | "region" | "school" | "title" | "skill" | "investor") | Yes | Kind of canonical people or company filter value to suggest. |

#### 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 Account Usage Logs

**Slug:** `DATAFORB2B_LIST_ACCOUNT_USAGE_LOGS`

Read one page of the connected DataForB2B account's credit-consumption history, with totals and breakdowns by endpoint and member.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | integer | No | Number of recent days to include (1-90). |
| `limit` | integer | No | Maximum individual usage-log entries in this page (1-1000). |
| `offset` | integer | No | Offset for pagination. |
| `endpoint` | string | No | Filter by API endpoint, such as /search/people; omit for all endpoints. |

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

**Slug:** `DATAFORB2B_LIST_ENRICHMENT_FIELDS`

List all fields DataForB2B can enrich, with each field's description and data source.

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

**Slug:** `DATAFORB2B_LIST_MONITOR_EVENTS`

Read one page of events delivered to a monitor. Event target and data objects may contain sensitive monitored information; this action does not change the monitor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of monitor events requested in this page. |
| `cursor` | string | No | Opaque continuation cursor from a previous List Monitor Events response. Pass it unchanged and omit it for the first page. |
| `offset` | integer | No | Zero-based event offset for the first page. Prefer cursor for continuation. |
| `monitor_id` | integer | Yes | Numeric ID of the monitor whose events to list. |

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

**Slug:** `DATAFORB2B_LIST_MONITORS`

List signal monitors owned by the connected account. Results include configured callback URLs, which may be sensitive; this action does not change monitor state.

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

**Slug:** `DATAFORB2B_LIST_SIGNALS`

List the catalog of signals that can be monitored, including their supported target and event types. This is read-only and does not create a monitor.

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

### Remove Monitor Targets

**Slug:** `DATAFORB2B_REMOVE_MONITOR_TARGETS`

Remove watched values or structured targets from an existing monitor. Confirm the exact monitor and targets first. This sends the required JSON request body on DELETE; the documented schema permits an empty object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `watch` | string | No | Provider-defined JSON value or values to remove from the watch set. |
| `values` | array | No | String values to remove from the monitor's watch set. |
| `targets` | array | No | Structured targets to remove from the monitor. |
| `monitor_id` | integer | Yes | Numeric ID of the monitor to update. |

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

### Reverse Lookup Work Email

**Slug:** `DATAFORB2B_REVERSE_LOOKUP_WORK_EMAIL`

Resolve a professional email address to a LinkedIn profile. DataForB2B uses deterministic company matching or LLM validation and reports the charge in credits_used.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Professional work email to resolve to a matching LinkedIn profile. |

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

### Run Reasoning Search

**Slug:** `DATAFORB2B_RUN_REASONING_SEARCH`

Run one finite turn of DataForB2B reasoning search. Clarification turns are free; a completed search costs a flat 2-credit agent fee plus the final per-result people-search charge. Continue needs_input responses with session_id and answers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Natural-language request, required on the first turn. |
| `answers` | object | No | Answers keyed by question ID for a continuation turn. |
| `category` | string ("people" | "companies") | No | Record category the reasoning agent should search. |
| `session_id` | string | No | Session returned by a needs_input turn. |
| `max_results` | integer | No | Maximum final results. Completed searches incur a 2-credit agent fee plus per-result search charges. |

#### 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:** `DATAFORB2B_SEARCH_COMPANIES`

Return one page of companies matching structured filters with up to three group levels, or a lookalike company. This read-like search does not change provider state, but each returned company consumes record credits; inspect credits_used and request only the records needed. Billing controls and provider debug data are not exposed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Maximum companies in this page (1-1000). Each returned company consumes record credits, so request only what the task needs. |
| `offset` | integer | No | Zero-based result offset for the first page. For continuation, pass next_cursor instead. |
| `filters` | object | No | Company filters with up to three group levels, shaped as {op, conditions}, where op is and, or, or not. Each condition is {column, type, value, value2?}; type is =, >, >=, <, <=, between, in, like, or not_in. Use a non-empty array value for in/not_in and provide value2 only for between. Mutually exclusive with lookalike_company. |
| `order_by` | string | No | Published company field to sort by; omit to use provider relevance ordering. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `order_direction` | string ("asc" | "desc") | No | Sort direction when order_by is provided. |
| `lookalike_company` | string | No | Company LinkedIn URL or universal-name slug to use as the similarity seed. Mutually exclusive with filters. |

#### 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 Jobs (Growth)

**Slug:** `DATAFORB2B_SEARCH_JOBS`

Search LinkedIn or Indeed jobs on the Growth plan. Each returned posting costs 0.25 record. Full LinkedIn descriptions add one upstream request per job and latency; inspect credits_used and request only what is needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Jobs to return; each returned job costs 0.25 record. |
| `cursor` | string | No | Opaque cursor from a previous Search Jobs response. |
| `offset` | integer | No | Zero-based offset for the first page. |
| `country` | string | No | Indeed country site; ignored by LinkedIn. |
| `keyword` | string | No | Job title, skill, or company keyword. |
| `distance` | integer | No | Radius in miles around location. |
| `job_type` | string ("fulltime" | "parttime" | "contract" | "temporary" | "internship") | No | Employment type filter. |
| `location` | string | No | Location used by both platforms. |
| `platform` | string ("linkedin" | "indeed") | No | Job platform. Growth plan required. |
| `work_type` | string ("onsite" | "remote" | "hybrid") | No | Onsite, remote, or hybrid work arrangement. |
| `company_ids` | string | No | Comma-separated encoded or numeric LinkedIn company IDs. |
| `date_posted` | string ("past_24h" | "past_week" | "past_month") | No | Posting freshness window. |
| `company_name` | string | No | Employer name; ignored when company_ids is provided. |
| `experience_level` | string ("internship" | "entry_level" | "associate" | "mid_senior" | "director" | "executive") | No | LinkedIn-only seniority filter. |
| `fetch_description` | boolean | No | Include full descriptions. LinkedIn makes one extra upstream request per job and is slower. |

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

**Slug:** `DATAFORB2B_SEARCH_LOOKALIKE`

Find profiles or companies similar to a supplied profile or company seed. Profile results cost 0.25 credit each according to the official API contract; inspect credits_used and keep count small.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Results to return; each profile costs 0.25 credit. |
| `cursor` | string | No | Opaque cursor from a previous Search Lookalike response. |
| `offset` | integer | No | Zero-based first-page offset. |
| `company` | string | No | LinkedIn company URL or universal name. |
| `country` | string | No | ISO country code restriction. |
| `profile` | string | No | LinkedIn profile URL, public ID, or member identity. |
| `location` | string | No | Profile or job location text restriction. |

#### 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:** `DATAFORB2B_SEARCH_PEOPLE`

Return one page of professional profiles matching structured filters (up to three group levels), semantic ranking, or lookalike criteria. Returned records consume the account balance; inspect credits_used and request only what is needed. Personal contact, private-field, billing, and debug controls are intentionally unavailable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Maximum profiles in this page. Returned profiles consume record credits, so request only what the task needs. |
| `cursor` | string | No | Opaque continuation cursor from a previous Search People response. Pass it unchanged; omit it for the first page. |
| `offset` | integer | No | Zero-based result offset for the first page. Prefer cursor for continuation when a previous response provides next_cursor. |
| `filters` | object | No | People filters with up to three group levels, shaped as {op, conditions}, where op is and, or, or not. Each condition is {column, type, value, value2?}; type is =, !=, >, >=, <, <=, in, not_in, like, not_like, or between. Use a non-empty array value for in/not_in. Provide value2 for between, or as the 1-300 km radius with = on profile_location_radius or current_job_location_radius; omit it otherwise. Optional when using lookalike_profile or rank_query. |
| `order_by` | string | No | Published profile field to sort by; omit to use provider relevance ordering. |
| `rank_query` | string | No | Short natural-language semantic ranking query applied in addition to hard filters. Keep it focused; returned relevance scores are search-relative. |
| `max_per_company` | integer | No | Maximum profiles from one company near the front of the results. |
| `order_direction` | string ("asc" | "desc") | No | Sort direction when order_by is provided. |
| `lookalike_profile` | string | No | LinkedIn profile URL, public identifier, or encoded prof_ ID whose characteristics should guide the search. |
| `exclude_no_picture` | boolean | No | Exclude profiles without a profile picture, matching the provider default. Set false only when incomplete profiles are needed. |
| `lookalike_use_case` | string ("sales" | "recruiter") | No | Ranking intent for a lookalike search; provide only with lookalike_profile. |

#### 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 Social Posts (Growth)

**Slug:** `DATAFORB2B_SEARCH_SOCIAL_POSTS`

Search LinkedIn, Twitter/X, or Reddit posts on the Growth plan. Each post costs 3 records and each included reaction or comment costs 2 records; inspect credits_used and keep count/include small.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Posts to return. Each returned post costs 3 records. |
| `match` | string ("strict" | "loose") | No | Strict verifies terms in the post text; loose returns raw platform matches. |
| `cursor` | string | No | Opaque cursor from a previous Search Social Posts response. |
| `offset` | integer | No | Zero-based offset for the first page. |
| `include` | array | No | Engager types to attach; each item must be reactions or comments. Each returned engager costs 2 records. |
| `keyword` | string | No | Keyword or phrase in post content. |
| `sort_by` | string ("date_posted" | "relevance") | No | Post ordering. |
| `platform` | string ("linkedin" | "twitter" | "reddit") | No | Social platform to search. Growth plan required. |
| `post_url` | string | No | Specific post URL whose engagers should be fetched instead of searching by keyword. |
| `posted_by` | string ("first" | "following" | "first,following") | No | LinkedIn relationship filter. |
| `subreddit` | string | No | Reddit-only subreddit restriction. |
| `date_posted` | string ("past_24h" | "past_week" | "past_month") | No | Post freshness window. |
| `from_member` | string | No | LinkedIn member URN of the author. |
| `content_type` | string ("ARTICLE" | "VIDEO" | "PHOTO" | "DOCUMENT") | No | LinkedIn-only content type. |
| `author_company` | string | No | LinkedIn-only author company name or numeric company ID. |
| `author_industry` | string | No | LinkedIn-only author industry. |
| `mentions_member` | string | No | LinkedIn member URN mentioned by the post. |
| `author_job_title` | string | No | LinkedIn-only author job title. |
| `engagement_count` | integer | No | Maximum engagers per included type, per post. |
| `from_organization` | string | No | Numeric LinkedIn organization ID of the author. |
| `mentions_organization` | string | No | LinkedIn organization ID mentioned by the post. |

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

**Slug:** `DATAFORB2B_SEARCH_WITH_LLM_V1`

Run the exact unversioned /search/llm natural-language search. The official contract charges 1 credit per returned profile; inspect result size and request only what is needed. Provider debug fields are omitted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | First-page number. |
| `count` | integer | No | Alias for page_size that takes priority when supplied. |
| `query` | string | Yes | Natural-language search request. |
| `cursor` | string | No | Opaque cursor from a previous Search With LLM V1 response. |
| `category` | string ("people" | "company") | Yes | Record category to search. |
| `order_by` | string | No | Provider record field used to sort results. |
| `page_size` | integer | No | Results per page; each returned profile costs 1 credit. |
| `output_fields` | array | No | Optional result fields to return. |
| `order_direction` | string ("asc" | "desc") | No | Sort direction. |
| `lookalike_use_case` | string ("sales" | "recruiter") | No | Intent when query contains a LinkedIn profile URL. |
| `show_private_fields` | boolean | No | Include private profile fields when authorized. |

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

**Slug:** `DATAFORB2B_SEARCH_WITH_LLM_V2`

Run the exact /search/llm/v2 route for hard-filter extraction and semantic ranking. Returned records consume the same credits as people search; inspect page size and request only what is needed. Provider debug fields are omitted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | First-page number. |
| `count` | integer | No | Alias for page_size that takes priority when supplied. |
| `query` | string | Yes | Natural-language search request used for hard-filter extraction and semantic ranking. |
| `cursor` | string | No | Opaque cursor from a previous Search With LLM V2 response. |
| `category` | string ("people" | "company") | No | People uses V2 ranking; company delegates to V1 behavior. |
| `page_size` | integer | No | Results per page; returned records consume search credits. |
| `prioritize` | string ("personal_email" | "work_email" | "phone") | No | Put profiles holding this contact type first; does not itself enrich contacts. |
| `max_per_company` | integer | No | Diversity cap for profiles from one employer near the front. |
| `lookalike_use_case` | string ("sales" | "recruiter") | No | Intent when query contains a LinkedIn profile URL. |
| `show_private_fields` | boolean | No | Include private profile fields when authorized. |

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

### Stream Reasoning Search

**Slug:** `DATAFORB2B_STREAM_REASONING_SEARCH`

Run one reasoning-search SSE turn and return a bounded transcript after the provider closes it. Output is capped at 100 events and 65,536 decoded data characters. Completed searches may incur the 2-credit reasoning fee plus result charges.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Natural-language request, required on the first turn. |
| `answers` | object | No | Answers keyed by question ID for a continuation turn. |
| `category` | string ("people" | "companies") | No | Record category the reasoning agent should search. |
| `session_id` | string | No | Session returned by a questions event. |
| `max_results` | integer | No | Maximum final results. Completion may incur reasoning and search 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 |

### Verify Email Deliverability

**Slug:** `DATAFORB2B_VERIFY_EMAIL_DELIVERABILITY`

Verify one email address without sending a message. A deliverable, undeliverable, or risky verdict costs 1 record; invalid and unknown verdicts are free.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to verify. The provider does not send an email. |

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