Documentation Index
Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
Use this file to discover all available pages before exploring further.
Paid Feature — Spotify is available on all paid plans (Starter, Pro, Enterprise). See pricing.
Overview
Use Spotify as a data source for Chartcastr. A single OAuth flow grants access to both the Spotify Web API (listening data, top tracks, top artists, artist catalog) and the Ads API (impressions, clicks, and spend across your Spotify Ads Manager campaigns). Chartcastr pulls these metrics on your schedule and delivers them as charts to Slack or email. Chartcastr connects with read-only scopes — we never modify campaigns, follows, playlists, or library content.Setup
Connect your Spotify account
In Chartcastr, go to Sources and select Spotify. Click Connect and complete the OAuth flow. You’ll be asked to authorise Chartcastr to read your top items and Ads reporting data.
Pick a metric
Choose which metric you want to track. Listening metrics (Top Tracks, Top Artists, Top Genres, Taste Shift) work for any Spotify account. Artist Release Timeline lets you scope to any artist on Spotify. Ads metrics only appear if your Spotify login owns at least one Ads Manager account.
Schedule the chart
Go to Connections → New Connection. Select your Spotify source, pick a destination (Slack channel or email), set the frequency, and optionally enable AI summaries. Most teams send a quarterly listening recap on the first of the month and Ads performance weekly.
Available Charts
Chartcastr supports 8 pre-built Spotify metrics across two subgroups.Listening & Artists
Top tracks, top artists, top genres, taste shift across time ranges, and the release timeline for any artist on Spotify.
Spotify Ads
Daily impressions, clicks, and spend across your Spotify Ads Manager campaigns. Requires an Ads Manager account.
View all available charts
See the full list of Spotify metrics with chart types and descriptions.
Data & Permissions
Chartcastr requests the following Spotify OAuth scopes (all read-only):| Scope | Purpose |
|---|---|
user-read-private | Identify the connected Spotify user |
user-read-email | Display the user’s email in the connection details |
user-top-read | Top tracks, top artists, top genres, taste shift |
user-read-recently-played | Reserved for future “recently played” charts |
user-library-read | Reserved for podcast metadata charts |
ads-read | Read-only Spotify Ads Manager reporting |
What data does Chartcastr access?
- Listening data: Your top tracks and artists across short / medium / long term windows, and genre tags for those artists.
- Artist catalog data: Public album and single release history for any artist you select for a release-timeline chart.
- Ads reporting: Daily impressions, clicks, and spend per ad account. We do not read individual creatives, audiences, or budgets.
Next Steps
Slack destination
Deliver Spotify charts to your Slack channels with AI summaries in the thread.
Email destination
Schedule Spotify recaps to any inbox or distribution list.
FAQ
Why don't my Spotify Ads metrics appear?
Why don't my Spotify Ads metrics appear?
Ads metrics are only enabled when the connected Spotify account has at least one ad account in Spotify Ads Manager. If you have an Ads Manager account but the metrics are still hidden, make sure you authorised the
ads-read scope when connecting and try reconnecting.Can I get monthly listeners or stream counts for an artist?
Can I get monthly listeners or stream counts for an artist?
No. Detailed artist analytics (monthly listeners, daily streams, save rate, audience demographics) are only available inside the Spotify for Artists dashboard or via Spotify’s partner Provider APIs (reserved for labels and distributors). The public Web API only exposes the artist’s current follower count, popularity score, and release catalog — which we use for the Artist Release Timeline chart.
How often is data refreshed?
How often is data refreshed?
Data is fetched fresh from Spotify every time a pulse fires. Chartcastr does not cache or store your listening or ads data between runs.
What date range is used for Ads charts?
What date range is used for Ads charts?
Spotify Ads charts default to a trailing 30-day window with daily granularity.
What about podcast analytics?
What about podcast analytics?
Spotify does not expose a public podcast analytics API. Spotify for Podcasters dashboard data (plays, listeners, retention) is dashboard-only. We will revisit podcast support if Spotify opens an API.