Icypeas · Contacts

Icypeas / Search the people database

Searches Icypeas's people dataset by filters on the person and their current or past company. Send query; pagination.size sets the page (1 to 200). Returns leads with name, headline, address and last company details in the same call. Priced per person returned; icypeas-find-people-count sizes a query first.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

pagination body · optional
Optional. Omit entirely for the first page (default page size 100), or set just `size` on that first call to change the page size; pass back the `token` from the previous response's `pagination` object to fetch the next page (leave `query` unchanged between pages -- changing it mid-pagination is undefined behavior, and tokens expire).
query body · required
Filter object for the people dataset. Each field takes {include:[...], exclude:[...]} (open text, max 200 values/array) unless noted. Person filters: firstname, lastname, currentJobTitle, pastJobTitle, school, languages, skills, location/profileLocation/workLocation (alpha-2 country codes preferred; a comma narrows a location, e.g. "Paris, France"), keyword (searches the whole profile). totalYearsOfExperience and timeInCurrentCompany are ranges, e.g. {">=": 5, "<=": 10}. Company filters come...

Provider docs How to run it