Particle Expertise Get
particle_expertise_getDescribe one occupation or field of research and, on request, who is booked under it: its parent, children and crosswalk by default; include: ["top_guests"] ranks the guests listed under it by podcast appearances in a window (default the last 30 days, at most 90), and include: ["top_podcasts"] ranks the shows that booked them. standing="established" ranks only credentialed or recognized experts — "the shows that book established finance experts" is field plus top_podcasts plus standing. A broad code covers everything below it.
Take codes from particle_expertise_resolve, which turns free text ("doctors", "finance") into them; on unresolved_reference or not_found, resolve and retry. Guest slugs work with particle_person_get (include: ["expertise"]) and particle_podcast_get_guest; podcast slugs with every podcast tool.
For a multi-criteria guest search (practicing, seniority, capacity, employer, all-time) use particle_podcast_list_guests; for one show's guest mix use particle_podcast_resolve with include: ["guest_expertise"].
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| field | No | 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. | |
| limit | No | Rows per top_ section (1-25, default 10). | |
| since | No | Window start for the top_ sections (YYYY-MM-DD). Defaults to 30 days before until; the window may span at most 90 days. | |
| until | No | Window end for the top_ sections (YYYY-MM-DD, inclusive). Defaults to now. | |
| include | 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). Default is the code with its parent, children and crosswalk. | |
| standing | No | Rank only guests whose standing is recognized this way (e.g. 'established' for credentialed experts). Applies to the top_ sections. | |
| min_guests | No | top_podcasts keeps shows that booked at least this many distinct guests in the code in the window (default 1). | |
| occupation | No | 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. | |
| min_podcasts | No | top_guests keeps guests seen on at least this many distinct shows in the window (default 1); raise it to favor guests booked across the medium over a show's regulars. | |
| output_format | No | Output serialization. 'markdown' (default) returns the LLM-facing rendering. 'json' returns the structured payload as JSON text — use only for programmatic chaining where exact field extraction matters; the JSON shape is larger and noisier for an LLM to read. |