{"uid":"cap_oisvBvgFwJIXX1HvCSSLa","slug":"particle-pro-list-guest-podcast-appearances-ebc7557e","name":"Particle Pro – List Guest Podcast Appearances","description":"List appearances for a podcast guest. Returns the chronological list of episodes a guest has appeared on, most recent first.","url":"https://api.particle.pro/v1/podcasts/guests/:id/appearances","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Person identifier — person slug (recommended), knowledge-graph entity slug, or encoded UUID"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"topic_id":{"type":"string","description":"Restrict to appearances on episodes classified under this topic"},"podcast_id":{"type":"string","description":"Restrict to appearances on a single podcast (slug or ID)"},"published_after":{"type":"string","description":"Only appearances published after this ISO 8601 date"},"published_before":{"type":"string","description":"Only appearances published before this ISO 8601 date"},"min_speaking_seconds":{"type":"integer","format":"int64","description":"Restrict to appearances with identified speaking time above this threshold"},"suitability_tier_max":{"enum":["SAFE","LIMITED","SENSITIVE","UNSAFE"],"type":"string","description":"Restrict to appearances on podcasts at or below this IAB Tech Lab brand-safety tier"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9wlpLR--BnBgygsOOjPWJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a chronological, most-recent-first list of podcast episodes a specific guest has appeared on, with optional filtering by topic, podcast, date range, speaking time, and brand-safety tier.","exampleAgentPrompt":"Pull up all the podcast episodes that Lex Fridman has appeared on in the last year — use his person slug 'lex-fridman', limit to 20 results, and only include appearances on SAFE-rated podcasts.","exampleUseCases":[{"title":"Guest research for podcast booking","prompt":"I'm considering booking Sam Altman for our podcast — can you pull his full appearance history from Particle Pro using his person slug 'sam-altman' so I can see which shows he's been on and how recently?"},{"title":"Topic-filtered guest episode discovery","prompt":"Find all episodes where Andrew Huberman has appeared that are classified under the 'health' topic — use his slug 'andrew-huberman' and restrict to episodes published after 2023-01-01."},{"title":"Brand-safe advertiser guest vetting","prompt":"I need to vet a potential sponsorship guest — pull the podcast appearances for person slug 'joe-rogan' but only show me episodes on podcasts rated SAFE or LIMITED for brand safety, with at least 600 seconds of speaking time."}],"resultDescription":"A paginated list of podcast episode appearance records for the specified guest, ordered most-recent-first. Each record includes episode and podcast identifiers, publication date, speaking time in seconds, and the podcast's brand-safety suitability tier. A pagination cursor is returned when more results are available.","failureModes":["Unknown guest ID returns 404 not found","Invalid suitability_tier_max enum value returns 400 bad request","Malformed ISO 8601 date strings for published_after/published_before return 400","No appearances matching filters returns empty results list","Expired or invalid pagination cursor returns 400 or empty results","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need structured, filterable episode-level appearance data for a specific podcast guest — especially when you need brand-safety filtering, topic scoping, or minimum speaking time thresholds. Prefer this over general podcast search when you already know the guest's identity and want their chronological appearance history across all podcasts in the Particle Pro index.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:37.427Z","isFirstParty":false}