{"uid":"cap_3Oh7SRWJSo1wXavGKSnpm","slug":"particle-pro-podcast-rankings-summary-f72dacef","name":"Particle Pro Podcast Rankings Summary","description":"Summarize a podcast's chart presence. Returns a one-call aggregate of the podcast's current chart presence: the number of distinct chart slots, sources, countries, and categories it appears on, plus the single best (lowest-numbered) rank it","url":"https://api.particle.pro/v1/podcasts/:id/rankings/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_GM-u_CABjj1FhXBHMQGd1","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 an aggregated snapshot of a podcast's current chart presence, including distinct chart slots, sources, countries, categories, and its best (lowest) rank.","exampleAgentPrompt":"Can you give me a chart summary for the podcast with ID 'serial' — how many charts is it on, which countries, and what's its best rank right now?","exampleUseCases":[{"title":"Podcast competitive chart benchmarking","prompt":"Pull up the chart summary for the podcast 'conan-obrien-needs-a-friend' — I want to know how many chart slots it holds, how many countries it's charting in, and its single best ranking position right now."},{"title":"Media buyer podcast reach evaluation","prompt":"I'm considering advertising on 'how-i-built-this' — can you check how many distinct chart sources and categories it's currently appearing on, plus its best rank, so I can gauge its reach?"},{"title":"Podcast growth monitoring over time","prompt":"Check the chart presence summary for podcast ID 1200361736 — I need the total chart slots, number of countries, number of categories, and the lowest rank number it's achieved right now."}],"resultDescription":"A single aggregated object containing: the total number of distinct chart slots the podcast occupies, the number of unique chart sources it appears on, the number of countries where it charts, the number of categories it ranks in, and its single best (lowest-numbered) rank across all charts.","failureModes":["Unknown podcast ID or slug returns 404","Invalid or malformed ID format may return 400","Podcast not currently on any charts may return empty/zero counts","Rate limiting or payment failure (x402 protocol) returns 402","Temporary upstream data unavailability returns 503"],"whenToPreferThis":"Choose this endpoint when you need a fast, single-call aggregate view of a podcast's chart presence rather than iterating through individual chart entries. Ideal for dashboards, competitive benchmarking, or media buying decisions where a high-level chart footprint (breadth of countries, sources, categories, and best rank) is more useful than granular per-chart data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:08.469Z","isFirstParty":false}