Podcast Rankings
tier:premium

Get historical rankings for a podcast

Returns the historical rank entries for a podcast across one or more chart slots. Optional filters narrow the scope (single source, single country, single category, or a date range).

get/v1/podcasts/{id}/rankings/history

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/{id}/rankings/history
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Podcast slug, internal ID, or numeric iTunes ID.

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

source'apple' | 'spotify'

Restrict to one source.

chart_type'top_podcasts'

Restrict to one chart type.

countrystring

Restrict to one country (ISO 3166-1 alpha-2; case-insensitive on input).

category_slugstring

Restrict to one category slug. Omit to include every category.

sincestring

Lower bound on captured_at (ISO 8601).

Example:2025-01-01T00:00:00Z
untilstring

Upper bound on captured_at (ISO 8601).

Example:2026-01-01T00:00:00Z

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.