particle_expertise_get

Describe one occupation or field of research and, on request, who is booked under it. By default the response is the code itself: its parent, its children and, for an occupation, its ISCO-08 or SOC 2018 crosswalk. Request the boards via include:

top_guests ranks the guests listed under the code by podcast appearances in a window, then by how many distinct shows booked them.
top_podcasts ranks the shows that booked the code’s guests most.

The window defaults to the last 30 days and may span at most 90. standing="established" ranks only credentialed or recognized experts, so “the shows that book established finance experts” is field plus top_podcasts plus standing. A broad code covers everything below it: a SOC major group or an ANZSRC division ranks every occupation or field inside it. Take codes from particle_expertise_resolve. Guest slugs work with particle_person_get (include: ["expertise"]) and particle_podcast_get_guest; podcast slugs work with every podcast tool. For a guest search with several criteria (practicing, seniority, capacity, employer, all-time appearances), use particle_podcast_list_guests. For one show’s guest mix, use particle_podcast_resolve with include: ["guest_expertise"].

Inputs

Field	Type	Required	Default	Description
`occupation`	string	one of	—	An occupation’s SOC 2018 or ISCO-08 code, slug or title from `particle_expertise_resolve` (e.g. `"cardiologists"`). Pass exactly one of `occupation` or `field`.
`field`	string	one of	—	A field of research’s ANZSRC 2020 code, slug or title from `particle_expertise_resolve` (e.g. `"banking-finance-and-investment"`). Pass exactly one of `occupation` or `field`.
`include`	array of enums	no	`[]`	Optional sections: `top_guests` (the guests in the code most booked in the window, with appearances, shows and last appearance) and `top_podcasts` (the shows that booked the code’s guests most). Unknown values are rejected with `invalid_parameter`.
`standing`	string	no	—	Rank only guests whose standing is recognized this way: `established` (conferred by others: a credential, a position, recognition in the field), `self_described`, or `unverified`. Applies to the `top_` sections.
`since`	string	no	30 days before `until`	Window start for the `top_` sections (`YYYY-MM-DD`). The window may span at most 90 days.
`until`	string	no	now	Window end for the `top_` sections (`YYYY-MM-DD`, inclusive).
`min_podcasts`	integer (≥1)	no	1	`top_guests` keeps guests seen on at least this many distinct shows in the window. Raise it to favor guests booked across the medium over one show’s regulars.
`min_guests`	integer (≥1)	no	1	`top_podcasts` keeps shows that booked at least this many distinct guests in the code in the window.
`limit`	integer (1–25)	no	10	Rows per `top_` section.

Passing neither occupation nor field returns missing_parameter; passing both returns invalid_input. A window longer than 90 days, or one whose since falls after until, returns invalid_parameter. A code that names nothing returns not_found with the closest codes as did-you-mean suggestions, pointing at particle_expertise_resolve.

Output

A markdown document with the code’s title as an H2, then **Standard:**, **Code:**, **Slug:** and **Level:** rows, a **Parent:** row (Title (code, slug)) below the top level, and an **Equivalents:** row for an occupation with crosswalk counterparts. A ### Children (N) section lists every code one level down, each as Title (code, slug). The following H3 sections appear when requested:

### Top guests — an italic line naming the window (and <standing> guests only when standing is set), then numbered lines formatted N. Name (person-slug) — A appearances on P shows, last YYYY-MM-DD.
### Top podcasts — the same window line, then numbered lines formatted N. Podcast title (podcast-slug) — A appearances by G guests, last YYYY-MM-DD.

A requested board with no rows says so in one sentence rather than disappearing. Sample (field="banking-finance-and-investment", include=["top_guests","top_podcasts"], standing="established", limit=3, truncated):

## Banking, finance and investment

**Standard:** anzsrc_for_2020
**Code:** 3502
**Slug:** banking-finance-and-investment
**Level:** 2
**Parent:** Commerce, management, tourism and services (35, commerce-management-tourism-and-services)

### Children (8)

- Environment and climate finance (350201, environment-and-climate-finance)
- Finance (350202, finance)
- Financial econometrics (350203, financial-econometrics)

### Top guests

_30 days before now to now, established guests only_
1. Mohamed El-Erian (mohamed-el-erian) — 14 appearances on 11 shows, last 2026-10-08
2. Liz Ann Sonders (liz-ann-sonders) — 12 appearances on 9 shows, last 2026-10-09
3. Jeremy Siegel (jeremy-siegel) — 9 appearances on 7 shows, last 2026-10-06

### Top podcasts

_30 days before now to now, established guests only_
1. Bloomberg Surveillance (bloomberg-surveillance) — 61 appearances by 48 guests, last 2026-10-09
2. Closing Bell (closing-bell) — 44 appearances by 37 guests, last 2026-10-09
3. Odd Lots (odd-lots) — 9 appearances by 9 guests, last 2026-10-07

Example

Agent calls: particle_expertise_get {
  "occupation": "cardiologists",
  "include": ["top_guests"],
  "since": "2026-08-01",
  "until": "2026-10-01",
  "min_podcasts": 2
}

REST equivalents: GET /v1/people/occupations/{code} and GET /v1/people/fields/{code} for the code; /guests and /podcasts below them for the boards, with the same standing parameter.
Find a code with particle_expertise_resolve.
Filter guests on more criteria with particle_podcast_list_guests; filter shows by their guest mix with particle_podcast_resolve.

Get started

Tools

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related