{"slug":"api-particle-pro-v1-podcasts-rankings-d035e7","title":"List podcast rankings","host":"api.particle.pro","method":"GET","resource":"https://api.particle.pro/v1/podcasts/rankings","category":"other","description":"List podcast rankings. Returns chart entries from the live ranking snapshot.","price_listed":0.03,"price_asked":0.03,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":198,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"category_slug":{"description":"Category slug (e.g. 'comedy', 'business'). Omit for the overall chart.","type":"string"},"chart_type":{"description":"Chart variant within the source. Currently only 'top_podcasts' is supported.","enum":["top_podcasts"],"type":"string"},"country":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'us', 'gb', 'jp'). Case-insensitive on input — normalized to lowercase server-side.","type":"string"},"cursor":{"description":"Opaque pagination cursor from previous response","type":"string"},"limit":{"description":"Results per page","format":"int64","type":"integer"},"max_rank":{"description":"Maximum rank (inclusive).","format":"int64","type":"integer"},"min_rank":{"description":"Minimum rank (inclusive). Useful for slicing the chart (e.g. min_rank=11&max_rank=20 for ranks 11–20).","format":"int64","type":"integer"},"podcast_id":{"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.","type":"string"},"source":{"description":"Ranking source platform. Use GET /v1/podcasts/rankings/sources to enumerate available sources.","enum":["apple","spotify"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.03,"price_match":true,"latency_ms":198,"error":null}],"description_full":"List podcast rankings. Returns chart entries from the live ranking snapshot.","last_updated":"2026-09-06T19:41:10.567Z","schemes":["exact"]}