> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Icypeas

> Icypeas is an email discovery and verification tool that allows users to find and verify professional email addresses using first name, last name, and company domain.

![Icypeas logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/icypeas.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=ba6c89c9929ad5f7a10f91e16bb27376)

* **Category:** people & contact data
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 22
* **Triggers:** 0
* **Slug:** `ICYPEAS`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Bulk Email Search
>
> **Slug:** `ICYPEAS_BULK_EMAIL_SEARCH`
>
> Initiate a bulk email search using names and company domains or names, with up to 5,000 rows per request; the job returns a file identifier for tracking and results. Managed Icypeas execution is unavailable.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> List of rows to search. Each row is a 3-element array: \[firstname, lastname, domainOrCompany]. At least one of firstname or lastname must be provided (the other can be null). domainOrCompany can be either a domain (e.g., 'google.com') or company name (e.g., 'Google Inc'). Maximum 5000 rows per request.
>
> **name** `string` *required*
>
> A descriptive name for this bulk search job. Used to identify the job in the Icypeas dashboard and API responses.
>
> **task** `string`
>
> Task type. Must be 'email-search' for bulk email lookups.
>
> **custom** `object`
>
> Extra options for webhook callbacks and tracking per row.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Profile URLs Bulk
>
> **Slug:** `ICYPEAS_BULK_FIND_PROFILE_URLS`
>
> Tool to perform bulk search for profile URLs based on firstname, lastname, and company/domain or job title. Use when you need LinkedIn profile URLs for multiple prospects. Accepts up to 50 profiles; some connections allow at most two. Returns immediate per-input results with the found URL (or an empty result for NOT\_FOUND) and terminal status. A search reference may also be returned.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per found profile URL
>
> **Discount:** 78
>
> #### Input Parameters
>
> **data** `array` *required*
>
> List of profiles to search. Maximum 50 items; some connections allow at most two.
>
> **type** `string`
>
> Type of bulk URL search. Must be 'profile' for profile URL search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk Reverse Email Lookup
>
> **Slug:** `ICYPEAS_BULK_REVERSE_EMAIL_LOOKUP`
>
> Look up LinkedIn profile URLs for 2–50 professional email addresses in one request, returning per-email results. Managed Icypeas execution is unavailable.
>
> #### Input Parameters
>
> **data** `array` *required*
>
> Array of professional email addresses to look up. Minimum 2 addresses, maximum 50 addresses per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scrape Bulk
>
> **Slug:** `ICYPEAS_BULK_SCRAPE`
>
> Retrieve multiple LinkedIn company or profile records in one request, up to 50 inputs. Completed responses return per-input data and terminal statuses inline. Some connections support only company mode with at most two inputs.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.95 per 100 found company profiles
>
> **Discount:** 78
>
> #### Input Parameters
>
> **data** `array` *required*
>
> Array of LinkedIn URLs to scrape. Maximum 50 URLs; some connections allow at most two canonical HTTPS company URLs without query parameters or fragments. For profiles: use LinkedIn profile URLs (e.g., [https://www.linkedin.com/in/username](https://www.linkedin.com/in/username)). For companies: use LinkedIn company URLs (e.g., [https://www.linkedin.com/company/companyname](https://www.linkedin.com/company/companyname)).
>
> **type** `string ("profile" | "company")` *required*
>
> The type of data to scrape. Use 'profile' for LinkedIn profiles or 'company' for LinkedIn companies. Some connections support company mode only.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check Search Progress
>
> **Slug:** `ICYPEAS_CHECK_PROGRESS`
>
> Check the processing progress of a single search item or bulk search file by ID, with pagination support. Managed Icypeas execution is unavailable.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID to check: for mode='single', the search item ID (\_id); for mode='bulk', the bulk file ID.
>
> **mode** `string ("single" | "bulk")` *required*
>
> Mode of progress check: 'single' for individual search items, 'bulk' for bulk file progress.
>
> **next** `boolean`
>
> Pagination direction: true to fetch the next page, false to fetch the previous page.
>
> **type** `string ("email-search" | "domain-scan" | "email-verification")`
>
> (mode='single' only) Filter results by task type.
>
> **limit** `integer`
>
> Maximum number of records to fetch per page. For single mode: max 100, default 10. For bulk mode: max 50, default 10.
>
> **sorts** `array`
>
> Pagination cursor from a previous response. Required when navigating to next/previous pages.
>
> **status** `string ("in_progress" | "done")`
>
> (mode='bulk' only) Filter bulk files by processing status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count Companies
>
> **Slug:** `ICYPEAS_COUNT_COMPANIES`
>
> Tool to count companies in Icypeas database matching specified filters without returning data or being charged. Use when you need to know how many companies match specific criteria like industry, location, or headcount.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per count request
>
> #### Input Parameters
>
> **query** `object` *required*
>
> Search filters object containing various field filters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Count People
>
> **Slug:** `ICYPEAS_COUNT_PEOPLE`
>
> Tool to count people matching specified filters without retrieving data; free. Use when you need to assess the size of a people search result set before running the actual query.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per count request
>
> #### Input Parameters
>
> **query** `object` *required*
>
> Search filters: include/exclude lists per field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Domain Scan
>
> **Slug:** `ICYPEAS_DOMAIN_SCAN`
>
> Initiate a scan for role-based email addresses using a domain or company name; the response may contain a search item ID and initial status for tracking. Managed Icypeas execution is unavailable.
>
> #### Input Parameters
>
> **custom** `object`
>
> Optional customization parameters for the scan
>
> **domainOrCompany** `string` *required*
>
> The domain or company name to scan for role-based email addresses
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Bulk Search Info
>
> **Slug:** `ICYPEAS_FETCH_BULK_SEARCH_INFO`
>
> Retrieve bulk search files with status and progress, optionally filtering by file or status, with pagination support. Managed Icypeas execution is unavailable.
>
> #### Input Parameters
>
> **file** `string`
>
> Filter results to a specific bulk search file by its unique ID. If provided, only that file's details are returned.
>
> **next** `boolean`
>
> Pagination direction when using 'sorts' cursor. Set to true to get the next page, false for previous page. Requires 'sorts' to be provided.
>
> **limit** `integer`
>
> Maximum number of bulk search files to return per page. Default is 10, maximum is 50.
>
> **sorts** `array`
>
> Pagination cursor obtained from the 'sorts' field of a previous response. Use with 'next\_page' to navigate through results.
>
> **status** `string ("in_progress" | "done")`
>
> Filter by search status. Use 'in\_progress' for running searches or 'done' for completed searches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Subscription Information
>
> **Slug:** `ICYPEAS_FETCH_SUBSCRIPTION_INFO`
>
> Retrieves subscription details and remaining credits for an Icypeas account, using the account owner's email associated with the API key. Unavailable for managed execution.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address of the Icypeas account owner. This must be the same email associated with the API key being used for authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Companies
>
> **Slug:** `ICYPEAS_FIND_COMPANIES`
>
> Tool to search companies in Icypeas database. Use when you need to find companies matching filters like industry, location, or headcount.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.038 per 100 search results
>
> **Discount:** 78
>
> #### Input Parameters
>
> **query** `object` *required*
>
> Search filters object containing various field filters.
>
> **pagination** `object`
>
> Pagination parameters for retrieving additional pages of results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Company URL
>
> **Slug:** `ICYPEAS_FIND_COMPANY_URL`
>
> Find a company profile URL using its name or domain. Completed responses return the URL and terminal status inline; responses may also include a search reference.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per found company URL
>
> **Discount:** 78
>
> #### Input Parameters
>
> **companyOrDomain** `string` *required*
>
> Either the full company name or its website domain.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reverse Email Lookup
>
> **Slug:** `ICYPEAS_FIND_LINKEDIN_PROFILE_BY_EMAIL`
>
> Find the LinkedIn profile URL behind a single professional email address. Use when you need to identify the person associated with an email address. Costs 10 credits per profile found.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.19 per found profile
>
> **Discount:** 78
>
> #### Input Parameters
>
> **email** `string` *required*
>
> A professional email address to look up (e.g., '[john.doe@company.com](mailto:john.doe@company.com)')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find People
>
> **Slug:** `ICYPEAS_FIND_PEOPLE`
>
> Search for people/leads in the Icypeas database. Supports filtering by name, job title, company, location, skills, languages, school, and keywords. Each filter supports include/exclude lists. Returns matching leads with pagination support for large result sets.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.038 per 100 search results
>
> **Discount:** 78
>
> #### Input Parameters
>
> **query** `object` *required*
>
> Search filters: include/exclude lists per field.
>
> **pagination** `object`
>
> Pagination settings for multi-page results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Profile URL
>
> **Slug:** `ICYPEAS_FIND_PROFILE_URL`
>
> Finds a person's LinkedIn profile URL using their name and company or job title. Use this tool when you need to find someone's LinkedIn profile URL. Provide the person's first name, last name, and either their company/domain OR job title. Tips for best results: - For company/domain, use the website domain (e.g., 'icypeas.com') or company name - Keep inputs simple - avoid over-specifying details - Costs 1 credit per profile URL found; NOT\_FOUND results are free Example: Find LinkedIn URL for Pierre Landoin at icypeas.com
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per found profile URL
>
> **Discount:** 78
>
> #### Input Parameters
>
> **jobTitle** `string`
>
> Job title of the person to help identify the correct profile (e.g., 'CEO', 'Software Engineer'). Required if companyOrDomain is not provided.
>
> **lastname** `string` *required*
>
> Last name of the person to search for (e.g., 'Landoin')
>
> **firstname** `string` *required*
>
> First name of the person to search for (e.g., 'Pierre')
>
> **companyOrDomain** `string`
>
> Company name or website domain to narrow the search (e.g., 'icypeas.com' or 'Icypeas'). Required if jobTitle is not provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Single Email
>
> **Slug:** `ICYPEAS_FIND_SINGLE_EMAIL`
>
> Initiates an asynchronous email search using a prospect's name and company or domain, returning a search item ID on success for retrieving the result. Unavailable for managed execution.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.019 per found email
>
> **Discount:** 78
>
> #### Input Parameters
>
> **custom** `object`
>
> Optional container for webhook and external tracking data.
>
> **lastname** `string`
>
> Prospect’s last name; required if firstname is omitted
>
> **firstname** `string`
>
> Prospect’s first name; required if lastname is omitted
>
> **domainOrCompany** `string` *required*
>
> The person’s company domain or company name
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Statistics Bulk Search
>
> **Slug:** `ICYPEAS_PARSE_BULK_SEARCH_STATISTICS`
>
> Parses the statistics data from a bulk search completion webhook. Unavailable for managed execution.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Bulk search summary and details
>
> **signature** `string` *required*
>
> HMAC-SHA1 signature of the payload
>
> **timestamp** `string` *required*
>
> ISO 8601 timestamp used to compute signature
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Search Results
>
> **Slug:** `ICYPEAS_RETRIEVE_SEARCH_RESULTS`
>
> Retrieves a search result by ID or paginates through bulk search results. Unavailable for managed execution.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per retrieval request
>
> #### Input Parameters
>
> **id** `string`
>
> \_id of the single result (required if mode='single')
>
> **file** `string`
>
> Bulk-file identifier (required if mode='bulk')
>
> **mode** `string ("single" | "bulk")` *required*
>
> Choose 'single' for one item or 'bulk' for bulk-file search
>
> **next** `boolean`
>
> Pagination direction: true for next page, false for previous
>
> **type** `string ("email-search" | "domain-scan" | "email-verification")`
>
> Task filter for single-mode only (not allowed when mode='bulk')
>
> **limit** `integer`
>
> Number of results per page (default 10, max 100)
>
> **sorts** `array`
>
> Pagination cursor from previous response
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scrape Company
>
> **Slug:** `ICYPEAS_SCRAPE_COMPANY`
>
> Retrieve company profile data from a LinkedIn company URL. Completed responses contain company data and terminal status inline; responses may include a search reference.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.95 per 100 found company profiles
>
> **Discount:** 78
>
> #### Input Parameters
>
> **url** `string` *required*
>
> LinkedIn company profile URL to scrape. Some connections require canonical HTTPS URLs without query parameters or fragments. Must be a valid LinkedIn company URL (e.g., [https://www.linkedin.com/company/microsoft](https://www.linkedin.com/company/microsoft)).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Scrape Profile
>
> **Slug:** `ICYPEAS_SCRAPE_PROFILE`
>
> Retrieve profile data from a public LinkedIn profile URL. Completed responses contain profile data and terminal status inline; responses may include a search reference.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$2.85 per 100 found profiles
>
> **Discount:** 78
>
> #### Input Parameters
>
> **url** `string` *required*
>
> LinkedIn profile URL to scrape. Some connections require canonical HTTPS URLs without query parameters or fragments. Must be a valid LinkedIn profile URL (e.g., [https://www.linkedin.com/in/username](https://www.linkedin.com/in/username)).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Setup Notifications
>
> **Slug:** `ICYPEAS_SETUP_NOTIFICATIONS`
>
> Provides instructions for setting up Icypeas push notifications and webhooks for bulk searches or single search updates. Unavailable for managed execution.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Verify Email Address
>
> **Slug:** `ICYPEAS_VERIFY_EMAIL`
>
> Initiates verification of an email address for deliverability, returning a verification item ID on success for retrieving the result. Unavailable for managed execution.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The email address to verify
>
> **custom** `object`
>
> Optional container for webhook and external tracking data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
