---
title: "Podcast ranking history"
method: GET
path: "/api/podcasts/{podcast_id}/rankings"
tags: ["Podcasts"]
---

# Podcast ranking history

`GET /api/podcasts/{podcast_id}/rankings`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/podcasts/{podcast_id}/rankings`
- Auth: HTTP bearer

Returns the historical chart positions for a single podcast across countries and platforms, most recent first. Useful for tracking a show's performance trajectory over time.

## Path parameters

- `podcast_id` string, required

## Response `200`

Ranking history (capped at the last few months)

- PodcastRankingHistoryEntry[]
  - `country_code` string, required
  - `date_checked` string, required
  - `platform` string, nullable
  - `rank` integer, nullable

## Other responses

- `401`: Missing or invalid API key
- `402`: No active subscription (paid endpoint requires a subscription)
- `403`: Endpoint not available on the caller's plan
- `404`: Podcast not found
- `429`: Monthly quota exhausted (response includes `usage: { current, limit }`)

---

[API](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api.md) · [All operations](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/revisions/29b5788227cf?raw)