{"uid":"cap_gZEBrejUozS_PsCTIbAl3","slug":"particle-pro-podcast-guest-recommendations-cefdd878","name":"Particle Pro Podcast Guest Recommendations","description":"List guests a podcast could plausibly book. Returns people who have guested on the podcast's related shows but never on this one, ranked by how related those venues are and how established the person is on them — a booking pipeline, not a","url":"https://api.particle.pro/v1/podcasts/:id/recommendations/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 (e.g., 'all-in'), internal ID, or numeric iTunes ID"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"include":{"type":"array","items":{"type":"string"},"description":"Optional response sections. Pass include=via to attach, for each recommended guest, the related shows that booked them."}}}},"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_1nfxn0oDLV8dDdTTJ00p7","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 ranked list of people who have guested on shows related to a given podcast but never appeared on it, forming a data-driven booking pipeline.","exampleAgentPrompt":"Who should I try to book as guests for the All In podcast? Give me a ranked list of people who've been on related shows but never appeared on All In, and include which shows they've guested on so I know the connection.","exampleUseCases":[{"title":"Filling a new podcast's guest pipeline","prompt":"I just launched a tech startup podcast and need guest ideas — can you pull recommendations for 'my-startup-pod' and include which related shows each person has been on so I understand why they're suggested?"},{"title":"Researching competitor podcast booking gaps","prompt":"I want to find guests who appear frequently on shows similar to 'lex-fridman' but have never been booked on Lex Fridman's podcast — give me the top 20 recommendations."},{"title":"Automating weekly booking outreach list","prompt":"Every Monday I need a fresh shortlist of 10 recommended guests for the 'acquired' podcast who haven't been on it yet — pull the current top recommendations for me."}],"resultDescription":"A paginated list of recommended guest profiles ranked by a combination of how related the venues they appeared on are to the target podcast, and how established the person is on those venues. Each entry can optionally include the specific related shows that booked that guest (via include=via), providing the chain of evidence for the recommendation. A pagination cursor is returned for fetching additional results.","failureModes":["Unknown podcast ID or slug returns a 404 not found error","Podcast with insufficient related show data may return an empty recommendations list","Invalid cursor value returns a pagination error","Requesting a very high limit may be capped or return fewer results than requested","Rate limiting or quota exhaustion returns a 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need a data-driven, pre-ranked pipeline of plausible podcast booking candidates derived from network-level guest data rather than manual research. It is especially valuable when you want to surface guests who are established on similar shows but represent genuine gaps on the target podcast, avoiding repeat bookings. Prefer this over generic people-search or social graph APIs when the specific context is podcast booking discovery grounded in actual guest appearance history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:09.457Z","isFirstParty":false}