{"uid":"cap_iPpO9X7iIMX3rcryIWp2y","slug":"particle-pro-podcast-ratings-summary-a7517a5f","name":"Particle Pro – Podcast Ratings Summary","description":"Summarize a podcast's ratings. Returns the numeric aggregate of a podcast's ratings — one entry per (platform, locale) it has been rated on, a combined cross-source roll-up, and the latest LLM-generated narrative summary of recent review text","url":"https://api.particle.pro/v1/podcasts/:id/ratings/summary","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, internal ID, or numeric iTunes ID."}}},"queryParams":{"type":"object","properties":{}}},"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_GVOaoQk_XsDycTLlT7AG9","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 aggregated numeric ratings and an LLM-generated narrative summary for a podcast, broken down by platform and locale plus a combined cross-source roll-up","exampleAgentPrompt":"Pull the full ratings summary for the podcast with iTunes ID 1200361736 — I want to see the breakdown by platform and locale, the combined roll-up score, and the latest AI-generated narrative of what listeners are saying.","exampleUseCases":[{"title":"Vetting a podcast for ad spend","prompt":"Before we commit budget, can you grab the ratings summary for the 'How I Built This' podcast — I want to see how it scores across platforms and what listeners are actually saying in recent reviews?"},{"title":"Competitive podcast benchmarking","prompt":"Pull the ratings summary for podcast ID 1200361736 so I can compare its cross-platform aggregate score against the other shows we're tracking this quarter."},{"title":"Monitoring audience sentiment shift","prompt":"Get me the latest ratings summary for the Lex Fridman Podcast, including the AI-generated narrative of recent listener reviews — I want to know if sentiment has changed since last month."}],"resultDescription":"Returns one ratings entry per (platform, locale) pair the podcast has been rated on, a combined cross-source numeric roll-up score, and an LLM-generated narrative summary synthesizing recent review text — all in a single response.","failureModes":["Invalid or unknown podcast ID returns a 404 not found error","Payment failure or insufficient USDC balance returns a 402 payment required response","Podcast exists but has no ratings data yet returns empty arrays with null roll-up","Rate limiting or quota exhaustion returns a 429 too many requests error","Malformed slug or non-numeric iTunes ID returns a 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need a one-call consolidated view of a podcast's ratings health — including per-platform breakdowns, locale-level granularity, a combined roll-up, and an AI narrative of listener sentiment — rather than querying multiple platform APIs individually or scraping review pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:40.728Z","isFirstParty":false}