Retrieve podcast download, listener, and engagement statistics using the Podbean Analytics and Stats API
domain: developers.podbean.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain an OAuth2 access_token scoped to the podcast per the Podbean Authentication docs
Pick a stats endpoint based on the metric: podcastStats/stats for downloads, podcastStats/platforms or podcastStats/sources or podcastStats/countries for breakdowns, podcastStats/userRetention for retention
Call GET api.podbean.com/v1/podcastStats/stats with access_token, start, end and period (m or d) for aggregated download stats
Call GET api.podbean.com/v1/engagementStats/stats with access_token, episode_id and period (all_time, this_month or last_month) for per-episode engagement
Call GET api.podbean.com/v1/analytics/podcastReports or podcastEngagementReports with access_token, podcast_id and year for raw exportable report data
Parse the returned JSON stats and stay within the leaky-bucket rate limit
Known gotchas
Every stats endpoint requires a valid access_token query parameter separate from the episode-publish OAuth flow
period values differ per endpoint: m/d for most stats, m/w for user retention, and named periods for engagement stats
end date defaults to yesterday if omitted or set to today or later, and the API enforces a 60-request leaky-bucket limit refilling 2 per second
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?