{"uid":"cap_n9aDYenOXokKv4jvL2dG_","slug":"particle-pro-podcast-rankings-c3c57e60","name":"Particle Pro Podcast Rankings","description":"List current rankings for a podcast. Returns every live chart appearance of the given podcast — across sources, countries, and categories.","url":"https://api.particle.pro/v1/podcasts/:id/rankings","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 (default: all)"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"}}}},"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_0ILCdhlJLdfjq359taddF","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 all current chart appearances of a given podcast across sources, countries, and categories.","exampleAgentPrompt":"What are the current chart rankings for the Lex Fridman Podcast — show me every country, category, and source it's appearing in right now.","exampleUseCases":[{"title":"Track podcast chart performance globally","prompt":"Can you pull up all the current chart rankings for 'The Daily' podcast — I want to see every country and category it's appearing in across all sources."},{"title":"Competitor podcast ranking analysis","prompt":"Look up the current rankings for the Lex Fridman Podcast across all charts and countries — I'm trying to compare it against our own show's performance."},{"title":"Monitor new podcast launch traction","prompt":"Check if the podcast with slug 'huberman-lab' is currently charting anywhere — list every chart appearance by source and category so I can see how it's doing."}],"resultDescription":"A list of live chart entries for the specified podcast, each including the ranking source, country, category, chart position, and any associated metadata. Results cover all simultaneous chart appearances across different platforms, regions, and genres.","failureModes":["Invalid or unknown podcast ID/slug returns a 404 or empty rankings list","Podcast exists but has no current chart appearances returns an empty array","Malformed pagination cursor returns an error or unexpected results","Rate limiting or payment failure returns a 402 or 429 error","Network timeout if the rankings data source is temporarily unavailable"],"whenToPreferThis":"Choose this endpoint when you need comprehensive, multi-source chart data for a specific podcast in real time — including global country-level and category-level breakdowns. It's ideal for competitive analysis, podcast performance monitoring, or verifying a show's reach across international markets. Prefer it over general media analytics tools when the specific focus is podcast chart rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:17.743Z","isFirstParty":false}