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

- **Category:** email
- **Auth:** API_KEY
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `ICYPEAS`
- **Version:** 20260211_00

## Tools

### Bulk Email Search

**Slug:** `ICYPEAS_BULK_EMAIL_SEARCH`

Initiate a bulk email search job to find professional email addresses for multiple people at once. Use this tool when you need to find emails for more than one person. Provide names (first and/or last) along with company domains or names. The API queues the job and returns a file identifier that can be used with 'Fetch Bulk Search Info' and 'Retrieve Search Results' to check progress and get results. Rate limit: 1 request per second. Maximum 5000 rows per bulk request.

### Check Search Progress

**Slug:** `ICYPEAS_CHECK_PROGRESS`

Check the processing progress of a search by its ID. Use this tool after initiating a single or bulk search to monitor its status. For mode='single': Checks progress of individual search items via /bulk-single-searchs/read endpoint. For mode='bulk': Checks progress of bulk search files via /search-files/read endpoint. Poll this endpoint periodically until 'finished' is True or item status is 'DEBITED'. Note: ICYPEAS recommends using webhooks instead of polling for production use.

### Domain Scan

**Slug:** `ICYPEAS_DOMAIN_SCAN`

Tool to scan a domain for role-based email addresses. Use when you need to discover all role-based emails for a specific domain.

### Fetch Bulk Search Info

**Slug:** `ICYPEAS_FETCH_BULK_SEARCH_INFO`

Retrieve bulk search files with their status and progress. Lists all bulk searches (email, profile, company searches) with pagination support. Use to monitor bulk operation progress, check completion status, or retrieve file IDs for further operations.

### Fetch Subscription Information

**Slug:** `ICYPEAS_FETCH_SUBSCRIPTION_INFO`

Retrieves subscription details and remaining credits for an Icypeas account. Use this to check credit balances, subscription status, and user ID before performing searches. The email parameter must match the account owner's email associated with the API key.

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

### Find Company URL

**Slug:** `ICYPEAS_FIND_COMPANY_URL`

Tool to find a single company profile URL using a company name or domain. Use when you need to initiate a profile-URL search for a given company identifier.

### 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. Requires credits to execute.

### 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 successful search Example: Find LinkedIn URL for Pierre Landoin at icypeas.com

### Find Profile URLs Bulk

**Slug:** `ICYPEAS_FIND_PROFILE_URLS_BULK`

Tool to perform bulk search for profile URLs based on firstname, lastname, and company/domain or job title. Use when you need to find LinkedIn or other social profile URLs for multiple prospects at once (up to 50 per request). The bulk search runs asynchronously. After submitting, use the returned file ID with the fetch_bulk_search_info or check_progress actions to monitor progress, then retrieve_search_results to get the profile URLs.

### Find Single Email

**Slug:** `ICYPEAS_FIND_SINGLE_EMAIL`

Initiates an asynchronous email search to find a prospect's email address using their name and company. Returns a search item ID that can be used with ICYPEAS_RETRIEVE_SEARCH_RESULTS to get the actual email. Use for individual lookups; for bulk operations, use ICYPEAS_BULK_EMAIL_SEARCH instead.

### Retrieve Search Results

**Slug:** `ICYPEAS_RETRIEVE_SEARCH_RESULTS`

Tool to retrieve the results of a search by ID or to paginate through bulk search results. Use after initiating a search to fetch individual or multiple search results.

### Scrape Company

**Slug:** `ICYPEAS_SCRAPE_COMPANY`

Tool to initiate scraping of a LinkedIn company page. Use when you have a LinkedIn company URL and need to retrieve company profile data. Returns a job ID that can be used with check_progress to fetch the full results.

### Scrape Profile

**Slug:** `ICYPEAS_SCRAPE_PROFILE`

Tool to initiate scraping of a LinkedIn profile. Use when you have a public LinkedIn profile URL and need a job ID and status to later fetch full details.

### Setup Notifications

**Slug:** `ICYPEAS_SETUP_NOTIFICATIONS`

Provides instructions for setting up Icypeas push notifications/webhooks. Use this tool when you need to configure real-time notifications for bulk searches or single search updates. Note: Webhooks must be configured via the Icypeas dashboard; there is no API endpoint for programmatic setup.

### Statistics Bulk Search

**Slug:** `ICYPEAS_STATISTICS_BULK_SEARCH`

Tool to parse bulk search statistics webhook. Use when processing the completion notification of a bulk search.
