Skip to main content
GET
/
v1
/
podcasts
/
{id}
/
rankings
/
summary
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/{id}/rankings/summary"
{
  "appearances_by_source": [
    {
      "best_rank": 123,
      "chart_count": 123,
      "best_category_slug": "<string>",
      "best_country": "<string>"
    }
  ],
  "category_count": 123,
  "chart_count": 123,
  "country_count": 123,
  "podcast": {
    "id": "<string>",
    "title": "<string>",
    "image_url": "<string>",
    "slug": "<string>"
  },
  "source_count": 123,
  "best_rank": {
    "captured_at": "2023-11-07T05:31:56Z",
    "rank": 123,
    "category_slug": "<string>",
    "country": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id
string
required

Podcast slug or ID.

Response

OK

appearances_by_source
object[] | null
required

Per-source breakdown of chart presence and best rank.

category_count
integer<int64>
required

Number of distinct categories currently charting this podcast.

chart_count
integer<int64>
required

Number of distinct chart slots (source × country × category) on which this podcast currently appears.

country_count
integer<int64>
required

Number of distinct countries currently charting this podcast.

podcast
object
required

The podcast this summary describes.

source_count
integer<int64>
required

Number of distinct sources currently charting this podcast.

best_rank
object

The single best (lowest-numbered) rank this podcast currently holds across all charts. Null when the podcast holds no current chart appearances.