Chartcastr supports 8 pre-built Spotify metrics across two subgroups, all unlocked by a single OAuth flow.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.
Listening & Artists (Web API)
| Metric | Chart Type | Description |
|---|---|---|
| Top Tracks — Last 6 Months ⭐ | Bar | Your most-played tracks over the last 6 months — the quarterly recap hero card |
| Top Artists — Last 6 Months | Bar | Your most-played artists over the last 6 months — pair with Top Tracks |
| Top Genres — Last 6 Months | Bar | Your most-listened genres, derived from your top artists weighted by rank |
| Taste Shift — 4w vs 6mo vs All-Time | Combo | How your top artists differ across short / medium / long term — what’s rising and falling |
| Artist Release Timeline | Stacked Bar | Albums and singles released per year for any selected artist on Spotify |
⭐ Top Tracks — Last 6 Months is the recommended starting metric — it’s the universally-loved “quarterly listening recap” everyone wants to share.
Spotify Ads
| Metric | Chart Type | Description |
|---|---|---|
| Ad Impressions Over Time | Line | Daily impressions across your Spotify Ads campaigns — top-of-funnel reach |
| Ad Clicks Over Time | Line | Daily clicks across your Spotify Ads campaigns — engagement signal |
| Ad Spend Over Time | Line | Daily spend across your Spotify Ads campaigns — budget pacing |
Spotify Ads metrics only appear in the metric picker when the connected Spotify account owns at least one Ads Manager account. If you don’t see them, reconnect with an account that has Ads access.
AI-Powered Summaries
Every Spotify chart is delivered with an AI-generated summary specific to the metric:- Top Tracks / Top Artists / Top Genres: highlight the standouts and call out genre shifts
- Taste Shift: surface artists trending up or fading out vs the longer-term baseline
- Artist Release Timeline: flag prolific years and long quiet stretches for the selected artist
- Ad Impressions / Clicks / Spend: spot day-of-week patterns, recent spikes, and budget pacing concerns
How AI analysis works in pulses
Learn how Chartcastr generates summaries, what context it uses, and how to get the most out of AI analysis.