Podcast Rankings
tier:premium

Get chart slot history

Returns historical chart snapshots for a chart slot, ordered most-recent first. Set since / until to bound the time range; set podcast_id to filter to one podcast within the slot.

get/v1/podcasts/rankings/history

Request

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

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

source'apple' | 'spotify'

Ranking source platform.

chart_type'top_podcasts'

Chart variant within the source.

countrystring

ISO 3166-1 alpha-2 country code; case-insensitive on input.

category_slugstring

Category slug. Omit for the overall chart.

podcast_idstring

Restrict to one podcast across the chart slot's history.

sincestring

Lower bound on captured_at (ISO 8601). Omit for no lower bound.

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

Upper bound on captured_at (ISO 8601). Omit for no upper bound.

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.