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.
Tools
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
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.
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.
Count People
Tool to count people matching specified filters without retrieving data or consuming credits. Use when you need to assess the size of a people search result set before running the actual query.
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
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.