{"uid":"cap_PF0iNBmc8TkkBnbW6KbgK","slug":"particle-pro-list-podcast-guests-278d0e9a","name":"Particle Pro – List Podcast Guests","description":"List the guest roster for a podcast. Returns the paginated set of identified guests who have appeared on the podcast, grouped by Person.","url":"https://api.particle.pro/v1/podcasts/:id/guests","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":"Podcast slug or ID"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"}}}},"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_BwPFaT1iXRkQRvc_uiebN","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 paginated list of identified guests who have appeared on a given podcast, grouped by Person.","exampleAgentPrompt":"Pull up the full guest roster for the 'How I Built This' podcast — show me the first 25 guests grouped by person.","exampleUseCases":[{"title":"Researching past guests for booking","prompt":"Who has appeared as a guest on the 'Lex Fridman Podcast'? Give me the first 50 guests so I can see who they've already had on before pitching new guests."},{"title":"Building a guest relationship map","prompt":"List all the identified guests who've appeared on the 'Masters of Scale' podcast — I want to map out the network of people Reid Hoffman has interviewed."},{"title":"Competitive podcast guest analysis","prompt":"Can you pull the guest roster for podcast ID 'founders-podcast' so I can compare which guests overlap with our own show's lineup?"}],"resultDescription":"A paginated JSON response containing a list of identified guests grouped by Person, each entry including guest identity details and their appearances on the podcast. The response includes an opaque pagination cursor for fetching subsequent pages and respects the requested page size limit.","failureModes":["Invalid or non-existent podcast ID/slug returns a 404 error","Expired or invalid pagination cursor returns an error or unexpected results","Podcast with no identified guests returns an empty list","Rate limiting or payment failure (x402) blocks the request","Malformed query parameters (e.g. non-integer limit) result in a validation error"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, paginated list of all past guests for a specific podcast grouped by person — ideal for guest research, booking intelligence, or competitive analysis. Prefer this over the 'plausible future guests' endpoint when you need historical appearance data rather than booking recommendations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:27.266Z","isFirstParty":false}