{"uid":"cap_kx9r4isEiFO2iqVkccN9X","slug":"particle-pro-list-podcast-ratings-e34f4e40","name":"Particle Pro – List Podcast Ratings","description":"List ratings for a podcast. Returns user-generated ratings (1-5 stars plus optional review text) captured from third-party platforms.","url":"https://api.particle.pro/v1/podcasts/:id/ratings","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. 'the-daily', 'lex-fridman-podcast'), internal ID, or numeric iTunes ID."}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"since":{"type":"string","description":"Lower bound on posted_at (ISO 8601)."},"until":{"type":"string","description":"Upper bound on posted_at (ISO 8601)."},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"locale":{"type":"string","description":"Restrict to one platform-specific locale (e.g. Apple storefront 'us'). Omit to return ratings across every locale."},"min_stars":{"type":"integer","format":"int64","description":"Lower bound on the star rating (inclusive)."},"platform_slug":{"type":"string","description":"Restrict to ratings from one platform (e.g. 'apple'). Omit to return ratings from every platform."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_L98Qn7znO4FYGrfurZaqp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns paginated user-generated star ratings (1–5) and optional review text for a specified podcast, aggregated from third-party platforms like Apple Podcasts.","exampleAgentPrompt":"Pull me the most recent listener ratings for the Lex Fridman Podcast from Apple Podcasts in the US, showing only reviews with 4 stars or above, up to 25 results.","exampleUseCases":[{"title":"Podcast quality audit before sponsorship","prompt":"I'm considering sponsoring 'How I Built This' — can you pull the latest listener ratings from Apple Podcasts US and show me how many are 4 stars or above so I can gauge audience satisfaction?"},{"title":"Competitive audience sentiment comparison","prompt":"I want to compare listener sentiment for 'The Daily' and 'Up First' — grab their ratings from all platforms and tell me which one has better audience reception recently."},{"title":"Monitor new episodes for listener backlash","prompt":"Can you check if there have been any new low-star ratings (1 or 2 stars) posted for the Hardcore History podcast since January 1st, 2025, so I can flag any listener complaints early?"}],"resultDescription":"A paginated list of rating objects, each containing a star value (1–5), optional review text, the source platform (e.g. 'apple'), locale, and a posted_at timestamp. Includes an opaque cursor for fetching the next page of results.","failureModes":["Unknown podcast ID or slug returns 404 not found","Invalid platform_slug returns 400 bad request","Invalid ISO 8601 date format for since/until returns 400","Exhausted pagination returns empty results with no cursor","Rate limiting or payment failure returns 402 or 429"],"whenToPreferThis":"Use this endpoint when you need structured, filterable listener rating data for a specific podcast — especially when you want to segment by platform (e.g. Apple only), locale (e.g. US storefront), star threshold, or date range. Prefer this over generic podcast search endpoints when the goal is audience sentiment analysis, sponsor due diligence, or monitoring listener reactions over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:55:30.528Z","isFirstParty":false}