People
tier:standard

Get a Person's expertise

Returns what the Person's records say about their expertise, in words: the SOC 2018 and ISCO-08 occupations and ANZSRC 2020 fields of research they are listed under (each usable as a filter by code, slug, or title), how their standing is recognized, their seniority and experience, how they know their field, where they work, and a sentence stating their credentials. Hosts, guests, panelists, and correspondents are read once linked to a podcast appearance; anyone else returns 404. The {id} parameter accepts the Person slug (recommended) or the encoded Person UUID.

get/v1/people/{id}/expertise

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/people/{id}/expertise
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Person identifier. Accepts the Person slug (recommended) or the encoded Person UUID.

Response

OK

capacitystring

How the speaker knows their field: researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, or layperson. Omitted when no single capacity is likely.

career_start_yearinteger

The year of the earliest dated role or degree in the speaker's records.

credentialstring

A sentence from the speaker's records, verbatim, that states their credentials.

experience'at_least_10_years' | 'at_least_25_years'

How long the speaker's career spans, from the earliest dated role or degree in their records or as the records state it; omitted under ten years or when the records do not say.

seniority'professional' | 'senior' | 'distinguished'

The highest level the speaker has reached in their field; omitted below professional.

standing'established' | 'self_described' | 'unverified' required

How the speaker's standing is recognized: established (conferred by others: a credential, a position, recognition in the field), self_described (claimed by the speaker), or unverified (the records do not say, which never means the speaker is not an expert).

Changes

No recorded changes to this operation across all 2 revisions of this API.