Find experts

Ranks the people listed under an occupation or field of research, most likely first, with their expertise as GET /v1/people//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.

GET /v1/people/expertise

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/people/expertise?limit=25"

200

{
  "data": [
    {
      "expertise": {
        "standing": "established",
        "capacity": "<string>",
        "career_start_year": 123,
        "credential": "<string>",
        "experience": "at_least_10_years",
        "fields": [
          {
            "code": "<string>",
            "slug": "<string>",
            "standard": "soc_2018",
            "title": "<string>",
            "group": "minor",
            "level": 123,
            "parent_code": "<string>"
          }
        ],
        "occupations": [
          {
            "code": "<string>",
            "slug": "<string>",
            "standard": "soc_2018",
            "title": "<string>",
            "established": true,
            "group": "minor",
            "level": 123,
            "parent_code": "<string>",
            "practicing": true
          }
        ],
        "organization": {
          "name": "<string>",
          "company": {
            "id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "domain": "<string>",
            "image_url": "<string>",
            "slug": "<string>",
            "ticker": "<string>"
          },
          "kind": "<string>"
        },
        "seniority": "professional"
      },
      "person": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "image_url": "<string>",
        "slug": "<string>"
      }
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

occupation · string

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.

Maximum string length: 200

field · string

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.

Maximum string length: 200

standing · enum<string>

Keep people whose standing is recognized this way (see standing on GET /v1/people/{id}/expertise).

Available options: established, self_described, unverified

seniority · enum<string>

Keep people at this seniority or above.

Available options: professional, senior, distinguished

practicing · boolean

Keep people who still work in the occupation, rather than having worked in it. Needs a SOC 2018 occupation or group.

capacity · enum<string>

Keep people who know their field in this capacity.

Available options: researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, layperson

employer · string

Keep people whose organization is this company: its slug (microsoft-corporation), domain (microsoft.com), or ID.

limit · integer<int64> · default: 25

Results per page.

Required range: 1 <= x <= 100

cursor · string

Opaque cursor from the previous page.

Response

200

application/json

OK

data · object[] · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results