{"uid":"cap_f3UiAoSwGVirWgocW-xdN","slug":"particle-pro-podcast-rankings-0813c92d","name":"Particle Pro Podcast Rankings","description":"List podcast rankings. Returns chart entries from the live ranking snapshot.","url":"https://api.particle.pro/v1/podcasts/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"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"source":{"enum":["apple","spotify"],"type":"string","description":"Ranking source platform. Use GET /v1/podcasts/rankings/sources to enumerate available sources."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g. 'us', 'gb', 'jp'). Case-insensitive on input — normalized to lowercase server-side."},"max_rank":{"type":"integer","format":"int64","description":"Maximum rank (inclusive)."},"min_rank":{"type":"integer","format":"int64","description":"Minimum rank (inclusive). Useful for slicing the chart (e.g. min_rank=11&max_rank=20 for ranks 11–20)."},"chart_type":{"enum":["top_podcasts"],"type":"string","description":"Chart variant within the source. Currently only 'top_podcasts' is supported."},"podcast_id":{"type":"string","description":"Restrict to chart appearances of a single podcast (slug, internal ID, or numeric iTunes ID). When set, the chart-slot filters narrow the result; without them every current chart appearance for the podcast is returned across slots."},"category_slug":{"type":"string","description":"Category slug (e.g. 'comedy', 'business'). Omit for the overall chart."}}}},"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_Gkvv1SFapcu-XqZzLaPwd","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 live snapshot of podcast chart rankings from Apple or Spotify, filterable by country, category, rank range, and specific podcast.","exampleAgentPrompt":"Pull the current top 20 comedy podcasts ranking on Apple for the US from Particle Pro's live chart snapshot.","exampleUseCases":[{"title":"Monitor competitor podcast rankings","prompt":"Check where 'The Daily' is currently ranking on Apple's top podcasts chart in the US — pull its current chart position from Particle Pro."},{"title":"Discover top podcasts by country and category","prompt":"Show me the top 10 business podcasts on Spotify in the UK right now using Particle Pro's live rankings."},{"title":"Track chart movement across rank slices","prompt":"Pull ranks 11 through 25 from the overall top podcasts chart on Apple in Canada so I can see who's just outside the top 10."}],"resultDescription":"A paginated list of chart entries from the live ranking snapshot, each containing the podcast's rank position, chart type, source platform (Apple or Spotify), country, and category. Includes an opaque pagination cursor for retrieving subsequent pages of results.","failureModes":["Invalid country code returns a 400 or empty result set","Unsupported source platform value returns a validation error","Requesting a podcast_id not currently on any chart returns an empty list","Invalid or expired pagination cursor returns an error or unexpected results","Rate limiting or payment failure (402) if x402 payment is not properly handled","category_slug typo returns empty results silently"],"whenToPreferThis":"Use this endpoint when you need live, ranked chart data for podcasts from Apple or Spotify, especially when you want to filter by country, category, or rank range. Prefer this over general podcast search endpoints when the goal is chart position or trend monitoring rather than content discovery by keyword.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:14.669Z","isFirstParty":false}