Use this to find people by role: title, description, whether the role is current, and filters on the person or organization.
Search
Send a POST to Person role search. role_title supports a boolean text search query.
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID in your shell first, as in the quickstart. See Authentication.
The response has search_results and total_search_results. The Recipes page shows a sample response and how to take the person.id into a phone number lookup.
Narrow the search with IDs
Filters such as person_skills, person_locations, person_industries, organizations and organization_keywords take numeric IDs. Get them from the Autocomplete endpoints. Autocomplete is limited to 10 requests per second per account.
Count first
Person role search totals accepts the same filters and returns total_search_results, total_persons and total_organizations. Use it to check the size of a query before paging through results with page.
Costs
See Credit pricing. Last modified on October 28, 2026
