Podcasts

Get podcast analytics

Get podcast analytics. Returns JSON unless otherwise noted.

Authentication

Authorizationbearer token

Requires podcasts.read — Read podcasts, seasons, episodes, feeds, and analytics.

Path parameters

podcastIdstringrequired

The podcast identifier.

Responses

200Successful response

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/podcasts/{podcastId}/analytics', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
  },
});

const data = await response.json();

Response200

{
  "days": 30,
  "episode_id": null,
  "summary": {
    "plays": 12840,
    "listeners": 9312,
    "requests": 20114,
    "bytes_delivered": 812304998
  },
  "series": [
    {
      "date": "2026-08-10",
      "plays": 431,
      "listeners": 318,
      "requests": 702,
      "bytes_delivered": 27140882
    }
  ],
  "episodes": [
    {
      "id": "3a7d2c11-45e8-4b90-9f21-6c0b8ad3e577",
      "title": "Building a publishing system",
      "plays": 4120,
      "listeners": 3011,
      "requests": 6544,
      "bytes_delivered": 261440512
    }
  ],
  "countries": [
    {
      "label": "FR",
      "plays": 5210,
      "listeners": 3894
    }
  ],
  "clients": [
    {
      "label": "Apple Podcasts",
      "plays": 6801,
      "listeners": 4922
    }
  ]
}