Analysis

AI Insights

Twelve analysis pipelines over live Spotify data — artist summaries, album reviews, track deep-dives, chart commentary, mood axes and viral scores. Pick a mode, fill its form, and the response below is the real one.

POST /ai/{mode} · 12 modes

Artist Summary

Editorial bio + key stats + style synthesis.

POST /ai/artist-summary
Try

Result

Pick a mode, fill the form, and run the analysis to see live output.

The twelve modes

Each mode is a dedicated pipeline tuned for one music-data task.

Types
Endpoint
/ai/types
Inputs
—
Description
List every available analysis mode and its parameters.
Analyze
Endpoint
/ai/analyze
Inputs
type + id
Description
Generic analyzer — pass {type, id} and get the right report for that entity.
Chart Trends
Endpoint
/ai/chart-trends
Inputs
country + period
Description
AI commentary on chart movement for a country & period.
Artist Summary
Endpoint
/ai/artist-summary
Inputs
artist id
Description
Editorial bio + key stats + style synthesis.
Album Review
Endpoint
/ai/album-review
Inputs
album id
Description
Long-form review with track highlights and verdict score.
Track Deep-Dive
Endpoint
/ai/track-deep-dive
Inputs
track id
Description
Lyric, production and cultural analysis of a single track.
Playlist Curator
Endpoint
/ai/playlist-curator
Inputs
prompt + seeds
Description
AI curator: generate a playlist concept from prompt + seeds.
Market Comparison
Endpoint
/ai/market-comparison
Inputs
countryA + countryB + period
Description
Side-by-side AI comparison of two country charts.
Genre Landscape
Endpoint
/ai/genre-landscape
Inputs
genre
Description
Map the leading artists, sub-genres and momentum of a genre.
Mood Profile
Endpoint
/ai/mood-profile
Inputs
track id
Description
Multi-axis mood scoring (energy, valence, intimacy, tension).
Viral Potential
Endpoint
/ai/viral-potential
Inputs
track id
Description
Predict viral score with reasoning and TikTok hook analysis.
Custom
Endpoint
/ai/custom
Inputs
prompt + JSON params
Description
Free-form prompt with structured params — anything goes.

What the analysis layer does

Every endpoint accepts a Spotify ID (track, artist, album or playlist) or a free-form prompt, runs the appropriate pipeline server-side, and returns either Markdown text or a structured JSON object you can render directly.

Teams use it for music-journalism dashboards, label A&R tooling, Discord bots, AI DJ assistants, marketing analytics and editorial CMS workflows.

Use cases

  • 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.

  • 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

    Pre-score hooks and releases for TikTok and short-video distribution.

  • Music education

    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

Unlimited access to all 12 AI modes plus 109 data endpoints. Pick the platform that fits your stack.

RapidAPI Apify Direct Portal