> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# particle_expertise_get

> One occupation or field of research, with optional boards of the guests booked under it and the shows that book them.

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`](/mcp/tools/people/expertise-resolve). Guest slugs work with [`particle_person_get`](/mcp/tools/people/person-get) (`include: ["expertise"]`) and [`particle_podcast_get_guest`](/mcp/tools/podcast_guests/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`](/mcp/tools/podcast_guests/podcast-list-guests). For one show's guest mix, use [`particle_podcast_resolve`](/mcp/tools/podcasts/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):

```markdown theme={"dark"}
## 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

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

## Related

* REST equivalents: [`GET /v1/people/occupations/{code}` and `GET /v1/people/fields/{code}`](/people/expertise#occupations-and-fields) for the code; [`/guests` and `/podcasts` below them](/people/expertise#who-is-being-booked) for the boards, with the same `standing` parameter.
* Find a code with [`particle_expertise_resolve`](/mcp/tools/people/expertise-resolve).
* Filter guests on more criteria with [`particle_podcast_list_guests`](/mcp/tools/podcast_guests/podcast-list-guests); filter shows by their guest mix with [`particle_podcast_resolve`](/mcp/tools/podcasts/podcast-resolve).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.