{"uid":"cap_ZYpmuVaxyPh9XMB_y5uND","slug":"particle-pro-podcast-rankings-movers-f87b003d","name":"Particle Pro Podcast Rankings Movers","description":"List ranking movers. Returns the chart entries whose rank changed between the live snapshot and the comparison snapshot window_days ago.","url":"https://api.particle.pro/v1/podcasts/rankings/movers?utm_source=zero.xyz","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"},"change":{"enum":["all","up","down","new","debut","reentry","exit"],"type":"string","description":"Filter by change type. 'up' / 'down' for podcasts whose rank moved, 'new' for every podcast that entered the chart (debuts and returning shows), 'debut' for podcasts on this chart slot for the first time since tracking began (May 2026), 'reentry' for returning shows, 'exit' for podcasts that fell off, 'all' returns every change type. 'new' rows carry 'debut' and 'first_charted_at' whichever filter selected them."},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"source":{"enum":["apple","spotify"],"type":"string","description":"Ranking source platform."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code; case-insensitive on input."},"chart_type":{"enum":["top_podcasts"],"type":"string","description":"Chart variant within the source."},"window_days":{"type":"integer","format":"int64","description":"Comparison window in days. The comparison snapshot is the most recent retired snapshot closest to (now - window_days). Default is 1 (vs. yesterday)."},"category_slug":{"type":"string","description":"Category slug. Omit for the overall chart."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ssGTp0VtL6A83g-yhAttQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns podcast chart entries whose rank changed between the current snapshot and a comparison snapshot N days ago, filterable by platform, country, category, and change type.","exampleAgentPrompt":"Show me the top 10 podcasts that moved up on the Apple charts in the US compared to 7 days ago — include new debuts and rank climbers.","exampleUseCases":[{"title":"Daily chart movers briefing","prompt":"Pull the podcasts whose rank changed on Spotify in the US since yesterday — show me the ones moving up and any new debuts, limit to 15 results."},{"title":"Weekly trend analysis by category","prompt":"Which podcasts in the true crime category entered or climbed the Apple top charts in the UK over the last 7 days?"},{"title":"Exit tracking for competitive research","prompt":"Which podcasts fell off the Apple top charts in Canada in the last 3 days? Give me all exits, up to 20 results."}],"resultDescription":"A list of podcast chart entries that experienced rank changes, including each podcast's identifier, previous and current rank positions, change type (up/down/new/exit), and associated metadata such as title and category. Results are scoped to the requested platform, country, chart type, and comparison window.","failureModes":["Invalid country code returns an error or empty results","Unsupported chart_type value returns a validation error","window_days with no available snapshot returns empty or approximate comparison","Invalid source/platform enum value causes a 400 error","No movers found for the given filters returns an empty list","Rate limiting or payment failure returns a 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need to track podcast chart momentum — specifically which shows are rising, falling, debuting, or exiting rankings on Apple or Spotify across different countries and categories. Prefer this over a static rankings list when change detection and trend analysis are the goal rather than a snapshot of current positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:12:25.729Z","isFirstParty":false,"canonicalSlug":"particle-pro-podcast-rankings-movers-f87b003d"}