{
"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>"
}{
"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.
{
"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>"
}{
"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
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.
200Was this page helpful?