---
title: "Get podcast catalog statistics"
method: GET
path: "/v1/podcasts/stats"
tags: ["Podcasts", "tier:free"]
---

# Get podcast catalog statistics

`GET /v1/podcasts/stats`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/podcasts/stats`
- Auth: none required

Returns live, catalog-wide statistics: how many podcasts the catalog covers, broken out by classification, how many episodes were added within recent trailing windows, and how many episodes are transcribed and how many more in podcasts' back catalogues are requestable. The podcast and added counts update as new podcasts and episodes are ingested and are cached for up to a minute, so they can drive live counters; the episode totals refresh hourly. This endpoint is free and requires no API key.

## Response `200`

OK

- PodcastStats
  - `episodes` EpisodeStats, required
    - `added` WindowCount[], nullable, required: Episodes added to the catalog within each trailing window.
      - `count` integer, required: Number of items within the window.
      - `window` '24h' | '7d', required: Trailing time window the count covers.
    - `totals` CorpusEpisodeCount[], nullable, required: The corpus by transcript_status: the episodes we have transcribed, and the episodes in podcasts' back catalogues we have discovered but not yet transcribed and whose audio we can transcribe. Episodes in other statuses (processing, queued, unavailable) are not counted here; a podcast's coverage counts every status. Refreshed hourly; see totals_counted_at.
      - `count` integer, required: Episodes with this status.
      - `transcript_status` 'transcribed' | 'requestable', required: transcribed: episodes with a transcript. requestable: episodes in podcasts' back catalogues, discovered but not yet transcribed, whose audio we can transcribe.
    - `totals_counted_at` string, date-time: When totals were computed. Absent before they have first been counted.
  - `podcasts` PodcastTotals, required
    - `totals` ClassificationCount[], nullable, required: Podcast counts by classification. Sum the entries for the total catalog size.
      - `classification` 'transcribed', required: Podcast classification the count covers. 'transcribed' podcasts have their episodes transcribed and analyzed.
      - `count` integer, required: Number of podcasts with this classification.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)