Skip to main content
POST
Person role search

When to use this endpoint

You have criteria, not a person: a job title, a company, an industry, a location or skills, and want a page of matching people with their current role. Take person.id from a result into the contact lookups. Filters that take IDs come from the autocomplete endpoints.

Example request

cURL
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.

Example response

200 (illustrative values)

Credits

Each request costs 1 credit. See API credits and pricing for how credits are charged and how to check what you spent.

Authorizations

X-API-KEY
string
header
required

Path Parameters

account_id
integer
required

Body

OrganizationPersonRole search request serializer.

page
integer
role_title
string

This field supports a boolean text search query.

role_description
string

This field supports a boolean text search query.

role_is_current
boolean
default:true
role_position_start_date
string<date>
role_position_end_date
string<date>
role_years_on_position_start
integer
role_years_on_position_end
integer
person_name
string

This field supports a boolean text search query.

person_headline
string

This field supports a boolean text search query.

person_description
string

This field supports a boolean text search query.

person_skills
integer[]

To get a list of IDs use Person skills lookup endpoint.

person_locations
integer[]

To get a list of IDs use Locations lookup endpoint.

person_industries
integer[]

To get a list of IDs use Industries lookup endpoint.

person_industries_exclude
integer[]

To get a list of IDs use Industries lookup endpoint.

person_linkedin_public_identifiers
string[]

LinkedIn person "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

organizations
integer[]

To get a list of IDs use Organizations lookup endpoint.

organizations_bulk_domain
string
organization_domains
string[]

This field supports a boolean text search query.

organization_description
string

This field supports a boolean text search query.

organization_locations
integer[]

To get a list of IDs use Locations lookup endpoint.

organization_industries
integer[]

To get a list of IDs use Industries lookup endpoint.

organization_industries_exclude
integer[]

To get a list of IDs use Industries lookup endpoint.

organization_keywords
integer[]

To get a list of IDs use Organization keywords lookup endpoint.

organization_web_technologies
integer[]

To get a list of IDs use Web technologies lookup endpoint.

organization_founded_date_start
string<date>
organization_founded_date_end
string<date>
organization_employees_start
integer
organization_employees_end
integer
organization_revenue_start
integer
organization_revenue_end
integer
organization_domain_rank_start
integer
organization_domain_rank_end
integer
organization_linkedin_public_identifiers
string[]

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/company/!slug!/".

funding_types
enum<string>[]
  • angel - Angel
  • convertible_note - Convertible Note
  • corporate_round - Corporate Round
  • debt_financing - Debt Financing
  • equity_crowdfunding - Equity Crowdfunding
  • grant - Grant
  • initial_coin_offering - Initial coin offering (ICO)
  • non_equity_assistance - Non-Equity Assistance
  • post_ipo_debt - Post-IPO Debt
  • post_ipo_equity - Post-IPO Equity
  • post_ipo_secondary - Post-IPO Secondary
  • pre_seed - Pre-Seed
  • private_equity - Private Equity
  • product_crowdfunding - Product Crowdfunding
  • secondary_market - Secondary Market
  • seed - Seed
  • series_a - Series A
  • series_b - Series B
  • series_c - Series C
  • series_d - Series D
  • series_e - Series E
  • series_f - Series F
  • series_g - Series G
  • series_h - Series H
  • series_i - Series I
  • series_j - Series J
  • series_unknown - Venture - Series Unknown
  • undisclosed - Undisclosed
Available options:
angel,
convertible_note,
corporate_round,
debt_financing,
equity_crowdfunding,
grant,
initial_coin_offering,
non_equity_assistance,
post_ipo_debt,
post_ipo_equity,
post_ipo_secondary,
pre_seed,
private_equity,
product_crowdfunding,
secondary_market,
seed,
series_a,
series_b,
series_c,
series_d,
series_e,
series_f,
series_g,
series_h,
series_i,
series_j,
series_unknown,
undisclosed
funding_total_start
integer
funding_total_end
integer
job_post_title
string

This field supports a boolean text search query.

job_post_description
string

This field supports a boolean text search query.

job_post_is_remote
boolean | null
job_post_is_active
boolean | null
job_post_date_featured_start
string<date>
job_post_date_featured_end
string<date>
job_post_locations
integer[]

To get a list of IDs use Locations lookup endpoint.

job_post_locations_exclude
integer[]

To get a list of IDs use Locations lookup endpoint.

simple_event_source
enum<string>
  • product_hunt - Product Hunt
  • form_c_sec_gov - Form C sec.gov
  • form_d_sec_gov - Form D sec.gov
Available options:
product_hunt,
form_c_sec_gov,
form_d_sec_gov
simple_event_reason
enum<string>
  • report_released - Report released
  • promoted_on_site - Promoted on site
Available options:
report_released,
promoted_on_site

Response

OrganizationPersonRole search response serializer.

search_results
object[]
required
read-only
total_search_results
integer
required
Required range: x >= 0
Last modified on November 1, 2026