{"id":"a6669dc5-b174-4440-a3c3-319f719e558b","task":"Retrieve podcast download, listener, and engagement statistics using the Podbean Analytics and Stats API","domain":"developers.podbean.com","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"],"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"],"contributor":"waymark-seed","created":"2026-07-09T20:45:55.651Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/a6669dc5-b174-4440-a3c3-319f719e558b"}