{"uid":"cap_mrU6Nrzvhm1FgpSbpPCZu","slug":"particle-pro-list-publisher-podcasts-with-suitability-verdicts-61fc396f","name":"Particle Pro – List Publisher Podcasts with Suitability Verdicts","description":"List a publisher's podcasts with their suitability verdicts. Returns a paginated list of the publisher's analyzed podcasts decorated with their latest IAB/GARM tier, confidence, evaluated-at timestamp, and any non-NONE category exposures (flagged","url":"https://api.particle.pro/v1/podcasts/publishers/:id/suitability/podcasts","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 publisher slug or ID."}}},"queryParams":{"type":"object","properties":{"sort":{"enum":["risk_desc","risk_asc","recently_evaluated"],"type":"string","description":"Sort order. risk_desc ranks the most-risky first (UNSAFE → SAFE); risk_asc inverts that; recently_evaluated sorts by most-recent assessment first."},"tier":{"type":"array","items":{"type":"string"},"description":"Filter to podcasts whose latest verdict is in this tier set. To OR-filter multiple tiers, pass a comma-separated list (e.g. ?tier=UNSAFE,SENSITIVE)."},"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"category":{"enum":["adult_sexual","arms_ammunition","crime_harmful_acts","death_injury_military_conflict","online_piracy","hate_speech_aggression","obscenity_profanity","illegal_drugs_alcohol_tobacco","spam_harmful","terrorism","debated_social_issues","misinformation"],"type":"string","description":"Filter to podcasts whose latest assessment shows non-NONE exposure in this GARM category."},"treatment":{"enum":["DOCUMENTARY","EDITORIAL","PROMOTIONAL","GLAMORIZING"],"type":"string","description":"When combined with category, filter to podcasts whose treatment in that category equals this value. Ignored without category."},"min_prevalence":{"enum":["INCIDENTAL","OCCASIONAL","FREQUENT","PERVASIVE"],"type":"string","description":"When combined with category, filter to podcasts whose prevalence in that category is at or above this threshold. Defaults to INCIDENTAL — any non-NONE prevalence. Ignored without category."}}}},"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_r6Y5iLzuKaxQDtrw2KO5W","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 a podcast publisher's analyzed podcasts decorated with IAB/GARM tier, confidence score, evaluation timestamp, and flagged category exposures.","exampleAgentPrompt":"Pull up the brand safety verdicts for all podcasts from publisher 'wondery', sorted by highest risk first, and flag any that are UNSAFE or have non-NONE exposure in the hate_speech_aggression category.","exampleUseCases":[{"title":"Pre-campaign brand safety audit","prompt":"Before we run ads on any iHeartMedia podcasts, show me all their shows sorted by risk from highest to lowest — I need to see which ones are UNSAFE or SENSITIVE and what categories got flagged."},{"title":"Filter podcasts by GARM drug content","prompt":"Which podcasts from publisher 'audioboom' have been flagged for illegal_drugs_alcohol_tobacco content with at least OCCASIONAL prevalence? Show me the most recently evaluated ones first."},{"title":"Monitor publisher suitability over time","prompt":"Get me the latest suitability assessments for all Wondery podcasts, filtering to just the ones that are SAFE — I want to build a whitelist of pre-approved shows for our ad campaign."}],"resultDescription":"A paginated list of podcast records, each including the podcast name and ID, its latest IAB/GARM suitability tier (e.g. SAFE, SENSITIVE, UNSAFE), a confidence score, the timestamp of the most recent evaluation, and any GARM category exposures with treatment type and prevalence level. A pagination cursor is included for retrieving subsequent pages.","failureModes":["Invalid or unknown publisher ID returns 404 not found","Invalid tier or category enum value returns 400 bad request","Expired or invalid pagination cursor returns 400 or empty result","No podcasts yet analyzed for the publisher returns empty list","treatment or min_prevalence filters ignored if category is not also specified","Rate limiting or payment failure returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need to audit or filter a specific publisher's entire podcast catalog for brand safety — especially when you require IAB/GARM-tier labels, GARM category-level exposure details, treatment type, and prevalence thresholds. Prefer this over a general podcast search when the publisher is already known and you want a structured safety verdict per show rather than keyword-based discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:13.193Z","isFirstParty":false}