{"uid":"cap_o5vCUCUxOvD7xqq4pT-uC","slug":"particle-pro-list-podcast-ranking-countries-d6627d29","name":"Particle Pro – List Podcast Ranking Countries","description":"List ranking countries. Returns every country currently represented in the rankings dataset, optionally restricted to a single source.","url":"https://api.particle.pro/v1/podcasts/rankings/countries","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 countries 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_17-9Q7PqsTHMNT2FhjUzV","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 country currently represented in the podcast rankings dataset, optionally filtered to Apple or Spotify as the source.","exampleAgentPrompt":"Can you pull up all the countries currently covered in the Particle Pro podcast rankings dataset, restricted to Spotify only?","exampleUseCases":[{"title":"Podcast market geographic scoping","prompt":"I'm building a podcast analytics dashboard — can you fetch all the countries that have podcast ranking data available on Particle Pro so I know which markets I can display charts for?"},{"title":"Apple vs Spotify country coverage comparison","prompt":"Can you list all the countries covered in Apple podcast rankings from Particle Pro, and then do the same for Spotify, so I can compare which markets each platform covers?"},{"title":"Validating country before ranking query","prompt":"Before I pull podcast charts for Brazil, can you check whether Brazil appears in the Particle Pro rankings countries list for Spotify so I know the data exists?"}],"resultDescription":"A list of countries (with country codes and/or names) currently represented in the podcast rankings dataset. If a source filter (apple or spotify) is provided, only countries with data from that source are returned. Supports pagination via cursor and limit parameters.","failureModes":["Invalid source value (not 'apple' or 'spotify') returns a 400 error","Invalid cursor token returns a 400 or 422 error","Empty result set if no countries are currently indexed","Payment failure via x402 protocol returns 402 if USDC not provided","Rate limiting may return 429 if called excessively"],"whenToPreferThis":"Use this endpoint when you need to discover which countries are available before querying country-specific podcast rankings, or when building a UI that lists supported markets. It is the correct starting point for any geographic scoping of podcast chart data on Particle Pro, especially when you need to filter by Apple or Spotify specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:08.705Z","isFirstParty":false}