Spotify AI Insights API
Turn raw Spotify data into editorial-quality analysis. Artist summaries, track deep-dives, chart trend reports, viral predictions and more — powered by LLMs over real-time music data.
Spotify AI Insights API
The Spotify AI Insights API wraps Spotify's structured data with an LLM analysis layer — turning raw JSON into publish-ready prose, comparison reports, mood profiles, viral-potential scores and curator recommendations. Every endpoint accepts a Spotify ID (track, artist, album or playlist) or a free-form prompt, runs the appropriate analysis pipeline server-side, and returns either Markdown text or a structured JSON object you can render directly.
Use it to power music journalism dashboards, label A&R tooling, Discord bots, AI DJ assistants, marketing analytics suites, and editorial CMS workflows. Below you can try every analysis mode live, see real responses from the production endpoint, and copy the exact request your app should make.
🎤 Artist Summary
Editorial bio + key stats + style synthesis.
POST /api/spotify/ai/artist-summaryQuick examples:
Result
12 Analysis Modes
Each mode is a dedicated AI pipeline tuned for a specific music-data task.
| Mode | Endpoint | Description |
|---|---|---|
| 📋Types | /ai/types | List every available analysis mode and its parameters. |
| ✨Analyze | /ai/analyze | Generic analyzer — pass {type, id} and get the right report for that entity. |
| 📈Chart Trends | /ai/chart-trends | AI commentary on chart movement for a country & period. |
| 🎤Artist Summary | /ai/artist-summary | Editorial bio + key stats + style synthesis. |
| 💿Album Review | /ai/album-review | Long-form review with track highlights and verdict score. |
| 🎵Track Deep-Dive | /ai/track-deep-dive | Lyric, production and cultural analysis of a single track. |
| 🎧Playlist Curator | /ai/playlist-curator | AI curator: generate a playlist concept from prompt + seeds. |
| 🌎Market Comparison | /ai/market-comparison | Side-by-side AI comparison of two country charts. |
| 🗺️Genre Landscape | /ai/genre-landscape | Map the leading artists, sub-genres and momentum of a genre. |
| 🌈Mood Profile | /ai/mood-profile | Multi-axis mood scoring (energy, valence, intimacy, tension). |
| 🚀Viral Potential | /ai/viral-potential | Predict viral score with reasoning and TikTok hook analysis. |
| 🛠️Custom | /ai/custom | Free-form prompt with structured params — anything goes. |
Use Cases
What teams ship with the Spotify AI Insights API.
Music Journalism
Auto-draft artist bios, album reviews and chart-trend explainers from live data.
Label A&R Tools
Score artists and tracks for viral potential, growth velocity and audience fit.
Marketing Analytics
Compare markets, surface emerging genres and brief campaigns automatically.
AI DJ Apps
Generate playlist concepts, transitions and on-the-fly track commentary.
Music Discovery Editorials
Build hub pages for genres and moods with rich, AI-written copy.
Fan Engagement
Power chatbots, Discord bots and stan accounts with track-level deep dives.
Viral Prediction Tools
Pre-score hooks and releases for TikTok and short-video distribution.
Music Education Content
Teach harmony, mood and production with AI-explained reference tracks.
FAQ
Which Spotify IDs do these endpoints accept?
Standard 22-character base62 Spotify IDs for tracks, artists, albums and playlists — the same IDs you see in Spotify share links after the resource type.
How fresh is the underlying data?
AI insights run on the same data layer as the rest of the API: charts refresh daily, artist/track metadata is fetched on-demand and cached, and recommendations use Spotify's live partner endpoints.
Do AI endpoints count against my regular quota?
Yes. Each AI call counts as one request against your plan's limits, the same as a normal data endpoint. RapidAPI and the Direct Portal both expose unlimited tiers.
What format do AI responses come back in?
Most modes return either a Markdown-formatted text field or a structured JSON object (e.g. mood-profile returns numeric axes). The /ai/types endpoint documents the exact response shape per mode.
Can I use this for commercial products?
Yes — paid RapidAPI and Direct Portal plans include commercial usage. Always credit Spotify for source data and follow their attribution guidelines for any derived content you publish.
Is custom mode a raw LLM passthrough?
No. /ai/custom still routes through our music-data tooling layer — you can pass a prompt and structured params, and the model has access to Spotify entity lookups, but it cannot perform arbitrary internet calls.
How do I prevent hallucinations in artist or album summaries?
All entity-bound modes (artist-summary, album-review, track-deep-dive, mood-profile, viral-potential) ground the model on the live Spotify metadata for that ID. For best results, always pass a real Spotify ID rather than a free-form name.
Ship AI music features today
Get unlimited access to all 12 AI modes plus 30+ data endpoints. Pick the platform that fits your stack.