Find experts
Ranks the people listed under an occupation or field of research, most likely first, with their expertise as GET /v1/people/{id}/expertise describes it. Narrow by standing, seniority, whether they still practice the occupation, how they know their field, a second field, or their employer. Occupations and fields accept a code, slug, or title (browse them with GET /v1/people/occupations and GET /v1/people/fields). Hosts, guests, panelists, and correspondents are read once linked to a podcast appearance.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/people/expertise
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Query parameters
Rank people listed under this occupation: a SOC 2018 or ISCO-08 code (29-1212), slug (cardiologists), or title (Cardiologists), or a SOC group or everyday name, such as physicians (29-1210) or doctors, which matches every occupation under it. A word with no occupation filters by the field of research or capacity it names (oncologists, founders); a capacity narrows but cannot rank. Browse values with GET /v1/people/occupations. A name both standards share means the SOC occupation. Either occupation or field is required.
Keep people listed under this ANZSRC 2020 field of research: a code (320101), slug, or title. Browse values with GET /v1/people/fields. Without an occupation, people are ranked under the field.
Keep people whose standing is recognized this way (see standing on GET /v1/people/{id}/expertise).
Keep people at this seniority or above.
Keep people who still work in the occupation, rather than having worked in it. Needs a SOC 2018 occupation or group.
Keep people who know their field in this capacity.
Keep people whose organization is this company: its slug (microsoft-corporation), domain (microsoft.com), or ID.
Results per page.
Opaque cursor from the previous page.
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.