particle_person_resolve.
The default response is lean. Request optional sections via include: external_links for LinkedIn/Wikipedia/social profiles, podcast_appearances for their most recent podcast appearances (episode and podcast slugs included for follow-up calls), companies for the full role history (the current role is included and marked (current)), sports for an athlete’s or coach’s current team (NFL, MLB and NHL players), sports, teams and leagues, expertise for what they know and how established they are (standing, seniority, and the occupations and fields they are listed under, with the codes that the guest_occupation/guest_field filters and particle_expertise_get accept).
For podcast-guest analytics (appearance stats, suitability exposure, co-appearance graph) use particle_podcast_get_guest with the same slug.
Inputs
Output
A markdown document with the person’s name as an H2, then a**Slug:** row (or **ID:** when no slug is backfilled), a **Current role:** row (Title, Company), a **Entity slug:** row when it differs from the slug, and a bio paragraph. The following H3 sections appear when the matching include value was requested and data is present:
### Companies— one bullet per role, formattedCompany — Title (current)(the(current)marker appears on the active role).### Expertise—**Standing:**(established,self_describedorunverified; unverified means the records do not say, never that the person is not an expert), then**Seniority:**,**Experience:**(with the career start year),**Capacity:**,**Organization:**and**Credential:**rows when known.**Occupations:**lists the SOC 2018 occupations, then the ISCO-08 groups, most specific first, each asTitle (code, slug)with— established, practicingflags on a detailed SOC occupation;**Fields:**lists the ANZSRC 2020 fields the same way. Every code and slug is a validoccupation/guest_occupationorfield/guest_fieldvalue. A person who has not yet spoken on an analyzed episode has no read, and the section says so in one sentence.### Sports— a**Current team:**row for an NFL, MLB or NHL player (Team (entity-slug), NFL roster as of YYYY-MM-DD, from the league’s current roster), a**Sports:**row, then one bullet per team, formattedTeam (entity-slug) — athlete|coach, League, 2017–2024, latest first, then oneLeague: Name (entity-slug), yearsbullet per league recorded on the person directly. Pass a team’s or league’s entity slug toparticle_entity_get. Only the**Current team:**row says where the person plays today. An open range (2017–) means no end year is recorded, which does not by itself mean the person is still on the team, and a player outside those three leagues has no current team.### External links— one bullet per platform, formattedPlatform: <url>(orPlatform: <identifier>for handle-only platforms).### Recent podcast appearances— one bullet per appearance, formattedEpisode title (episode-slug) on Podcast title (podcast-slug) — YYYY-MM-DD. The slugs round-trip into the podcast tools. (Capped at the 10 most recent; for the full paginated history useparticle_podcast_get_guestwithinclude: ["appearances"].)
person_slug="sam-altman", include=["companies","podcast_appearances"], truncated):
person_slug="patrick-mahomes", include=["sports"], truncated):
person_slug="eric-topol", include=["expertise"], truncated):
Example
Related
- REST equivalent:
GET /v1/people/{id}(request/response contract in the API reference). - For appearance analytics (stats, suitability exposure), use
particle_podcast_get_guestwith the same slug. - REST equivalent for
include: ["expertise"]:GET /v1/people/{id}/expertise. Look up or browse occupation and field codes withparticle_expertise_resolve. - Resolve a name to a slug first with
particle_person_resolveorparticle_entity_resolve.