particle_podcast_list_guests
Browse podcast guests across the catalog, in two opinionated modes:
directory(default): the guest directory ranked by lifetime appearances (guests with 2+ appearances).trends: who's making the rounds right now — guests with appearances on 2+ distinct podcasts in the last 30 days, which surfaces cross-show press tours rather than show regulars. The press-tour shape is enforced: every in-window appearance must be on a different podcast, each needs 5+ minutes of identified speaking time, mononymous catch-all people are excluded, and the in-window rate must be a 2x spike over the guest's lifetime baseline.
podcast_slug switches the directory to one show's roster: every guest who has appeared on that podcast, ranked by appearances on the show (one-off guests included). topic_slug narrows either corpus mode to guests appearing on episodes about that topic. Guest slugs ARE person slugs — feed them into particle_podcast_get_guest for the appearance profile or particle_person_get for the person profile.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | What to return. 'directory' (default): the guest directory ranked by lifetime appearances. 'trends': guests trending right now — appearances on 2+ distinct podcasts in the last 30 days (cross-show press tours, not regulars). | |
| field | No | Only guests listed under this ANZSRC 2020 field of research: a code, slug or title from particle_expertise_resolve (e.g. 'banking-finance-and-investment'). Directory mode only. | |
| limit | No | Guests per page (1-50, default 20). | |
| cursor | No | Opaque pagination cursor from a previous response. | |
| include | No | Optional per-guest sections: 'expertise' (each guest's standing, seniority, most specific occupation and field, and organization on one line). Directory mode only. | |
| capacity | No | Only guests who know their field in this capacity. Directory mode only. | |
| employer | No | Only guests whose organization is this company (slug from particle_company_resolve, or a domain). Directory mode only. | |
| standing | No | Only guests whose standing is recognized this way: 'established' (conferred by others: a credential, a position, recognition in the field), 'self_described', or 'unverified'. Directory mode only. | |
| seniority | No | Only guests at this seniority or above. Directory mode only. | |
| occupation | No | Only guests listed under this occupation: a SOC 2018 or ISCO-08 code, slug or title from particle_expertise_resolve (e.g. 'cardiologists' or '29-1212'). Directory mode only. | |
| practicing | No | Only guests who still work in the occupation. Needs a detailed SOC 2018 occupation (e.g. '29-1212' Cardiologists). Directory mode only. | |
| topic_slug | No | Restrict to guests with appearances on episodes classified under this topic (slug from particle_topic_browse, e.g. 'technology/artificial-intelligence'). Ignored when podcast_slug is set. | |
| podcast_slug | No | Return one show's guest roster instead of the corpus directory: every guest who has appeared on this podcast, ranked by appearances on the show (no lifetime-appearance floor). Slug from particle_podcast_resolve. Only valid with the default directory mode. A particle.pro or Radar show link also works. | |
| 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. | |
| appeared_since | No | Only guests with an appearance on or after this date (YYYY-MM-DD or ISO 8601). Directory mode only. |