{"uid":"cap_gSNnHzpfeuTpnciV309ZE","slug":"particle-pro-list-podcast-ranking-categories-c873e77c","name":"Particle Pro – List Podcast Ranking Categories","description":"List ranking categories. Returns every category currently represented in the rankings dataset, optionally restricted to a single source.","url":"https://api.particle.pro/v1/podcasts/rankings/categories","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 (default: all)"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"source":{"enum":["apple","spotify"],"type":"string","description":"Restrict the listing to one source. Omit to return categories with current data from any source."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WmBpucyADSrZQ3pRHEUx5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns every podcast ranking category currently in the dataset, optionally filtered by source (Apple or Spotify).","exampleAgentPrompt":"What podcast ranking categories are currently tracked on Particle Pro for Apple podcasts? Show me all of them.","exampleUseCases":[{"title":"Discover Apple Podcast chart genres","prompt":"Can you pull the list of all podcast ranking categories that Particle Pro has data for on Apple — I want to see every genre they track."},{"title":"Find Spotify podcast ranking topics","prompt":"What categories does Particle Pro use when ranking Spotify podcasts? List them all so I can pick which ones to monitor."},{"title":"Survey all tracked podcast categories","prompt":"Give me every podcast ranking category in Particle Pro's dataset, regardless of source — I want to see the full list across Apple and Spotify."}],"resultDescription":"A list of category names (and associated metadata) currently represented in the podcast rankings dataset. May include pagination cursor for fetching additional results if the list is long. Filterable to Apple or Spotify categories only.","failureModes":["Invalid source enum value returns a 400 validation error","Invalid cursor string causes a 400 or 422 pagination error","No categories available returns an empty list rather than an error","Rate limiting or payment failure (402) if credit is insufficient"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate the podcast ranking categories tracked by Particle Pro before querying rankings within a specific category. It is the appropriate first step when building a podcast chart browser, populating a category filter dropdown, or checking which genres are tracked for a given source (Apple or Spotify).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:44.090Z","isFirstParty":false}