curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/expertise?limit=25"{
"data": [
{
"expertise": {
"standing": "established",
"capacity": "<string>",
"career_start_year": 123,
"credential": "<string>",
"experience": "at_least_10_years",
"fields": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"occupations": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"established": true,
"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>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}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.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/expertise?limit=25"{
"data": [
{
"expertise": {
"standing": "established",
"capacity": "<string>",
"career_start_year": 123,
"credential": "<string>",
"experience": "at_least_10_years",
"fields": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"occupations": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"established": true,
"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>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Rank people listed under this occupation: a SOC 2018 or ISCO-08 code (29-1212), slug (cardiologists), or title (Cardiologists). Browse values with GET /v1/people/occupations. A name both standards share means the SOC occupation. Either occupation or field is required.
200Keep 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.
200Keep people whose standing is recognized this way (see standing on GET /v1/people/{id}/expertise).
established, self_described, unverified Keep people at this seniority or above.
professional, senior, distinguished Keep people who still work in the occupation, rather than having worked in it. Needs a detailed SOC 2018 occupation.
Keep people who know their field in this capacity.
researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, layperson Keep people whose organization is this company: its slug (microsoft-corporation), domain (microsoft.com), or ID.
Results per page.
1 <= x <= 100Opaque cursor from the previous page.
Was this page helpful?