Skip to main content
Icypeas logo
  • 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

Slug: ICYPEAS_BULK_EMAIL_SEARCHInitiate 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

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.
string
required
A descriptive name for this bulk search job. Used to identify the job in the Icypeas dashboard and API responses.
string
Task type. Must be ‘email-search’ for bulk email lookups.
object
Extra options for webhook callbacks and tracking per row.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_BULK_FIND_PROFILE_URLSTool 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 URLDiscount: 78

Input Parameters

array
required
List of profiles to search. Maximum 50 items; some connections allow at most two.
string
Type of bulk URL search. Must be ‘profile’ for profile URL search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_BULK_REVERSE_EMAIL_LOOKUPLook up LinkedIn profile URLs for 2–50 professional email addresses in one request, returning per-email results. Managed Icypeas execution is unavailable.

Input Parameters

array
required
Array of professional email addresses to look up. Minimum 2 addresses, maximum 50 addresses per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_BULK_SCRAPERetrieve 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 profilesDiscount: 78

Input Parameters

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). For companies: use LinkedIn company URLs (e.g., https://www.linkedin.com/company/companyname).
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_CHECK_PROGRESSCheck the processing progress of a single search item or bulk search file by ID, with pagination support. Managed Icypeas execution is unavailable.

Input Parameters

string
required
The ID to check: for mode=‘single’, the search item ID (_id); for mode=‘bulk’, the bulk file ID.
string ("single" | "bulk")
required
Mode of progress check: ‘single’ for individual search items, ‘bulk’ for bulk file progress.
boolean
Pagination direction: true to fetch the next page, false to fetch the previous page.
string ("email-search" | "domain-scan" | "email-verification")
(mode=‘single’ only) Filter results by task type.
integer
Maximum number of records to fetch per page. For single mode: max 100, default 10. For bulk mode: max 50, default 10.
array
Pagination cursor from a previous response. Required when navigating to next/previous pages.
string ("in_progress" | "done")
(mode=‘bulk’ only) Filter bulk files by processing status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_COUNT_COMPANIESTool 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

object
required
Search filters object containing various field filters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_COUNT_PEOPLETool 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

object
required
Search filters: include/exclude lists per field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_DOMAIN_SCANInitiate 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

object
Optional customization parameters for the scan
string
required
The domain or company name to scan for role-based email addresses

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FETCH_BULK_SEARCH_INFORetrieve bulk search files with status and progress, optionally filtering by file or status, with pagination support. Managed Icypeas execution is unavailable.

Input Parameters

string
Filter results to a specific bulk search file by its unique ID. If provided, only that file’s details are returned.
boolean
Pagination direction when using ‘sorts’ cursor. Set to true to get the next page, false for previous page. Requires ‘sorts’ to be provided.
integer
Maximum number of bulk search files to return per page. Default is 10, maximum is 50.
array
Pagination cursor obtained from the ‘sorts’ field of a previous response. Use with ‘next_page’ to navigate through results.
string ("in_progress" | "done")
Filter by search status. Use ‘in_progress’ for running searches or ‘done’ for completed searches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FETCH_SUBSCRIPTION_INFORetrieves 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FIND_COMPANIESTool 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 resultsDiscount: 78

Input Parameters

object
required
Search filters object containing various field filters.
object
Pagination parameters for retrieving additional pages of results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FIND_COMPANY_URLFind 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 URLDiscount: 78

Input Parameters

string
required
Either the full company name or its website domain.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FIND_LINKEDIN_PROFILE_BY_EMAILFind 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 profileDiscount: 78

Input Parameters

string
required
A professional email address to look up (e.g., ‘john.doe@company.com’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FIND_PEOPLESearch 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 resultsDiscount: 78

Input Parameters

object
required
Search filters: include/exclude lists per field.
object
Pagination settings for multi-page results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FIND_PROFILE_URLFinds 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.comInstant: Supported on the latest version.Instant pricing: $0.019 per found profile URLDiscount: 78

Input Parameters

string
Job title of the person to help identify the correct profile (e.g., ‘CEO’, ‘Software Engineer’). Required if companyOrDomain is not provided.
string
required
Last name of the person to search for (e.g., ‘Landoin’)
string
required
First name of the person to search for (e.g., ‘Pierre’)
string
Company name or website domain to narrow the search (e.g., ‘icypeas.com’ or ‘Icypeas’). Required if jobTitle is not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_FIND_SINGLE_EMAILInitiates 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 emailDiscount: 78

Input Parameters

object
Optional container for webhook and external tracking data.
string
Prospect’s last name; required if firstname is omitted
string
Prospect’s first name; required if lastname is omitted
string
required
The person’s company domain or company name

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_PARSE_BULK_SEARCH_STATISTICSParses the statistics data from a bulk search completion webhook. Unavailable for managed execution.

Input Parameters

object
required
Bulk search summary and details
string
required
HMAC-SHA1 signature of the payload
string
required
ISO 8601 timestamp used to compute signature

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_RETRIEVE_SEARCH_RESULTSRetrieves 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

string
_id of the single result (required if mode=‘single’)
string
Bulk-file identifier (required if mode=‘bulk’)
string ("single" | "bulk")
required
Choose ‘single’ for one item or ‘bulk’ for bulk-file search
boolean
Pagination direction: true for next page, false for previous
string ("email-search" | "domain-scan" | "email-verification")
Task filter for single-mode only (not allowed when mode=‘bulk’)
integer
Number of results per page (default 10, max 100)
array
Pagination cursor from previous response

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_SCRAPE_COMPANYRetrieve 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 profilesDiscount: 78

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_SCRAPE_PROFILERetrieve 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 profilesDiscount: 78

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_SETUP_NOTIFICATIONSProvides instructions for setting up Icypeas push notifications and webhooks for bulk searches or single search updates. Unavailable for managed execution.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ICYPEAS_VERIFY_EMAILInitiates verification of an email address for deliverability, returning a verification item ID on success for retrieving the result. Unavailable for managed execution.

Input Parameters

string
required
The email address to verify
object
Optional container for webhook and external tracking data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not