shnwazdev-jiomusicapi

Unofficial JioMusic search API

Music metadata, preview links, and health checks from one Flask API.

A Vercel-ready API wrapper with JSON endpoints, legacy route support, and a simple testing console for song, album, and playlist searches.

Open sample JSON Check health 
{
  "ok": true,
  "query": "slow motion",
  "counts": {
    "songs": 5,
    "albums": 5,
    "artists": 1,
    "topquery": 1
  }
}

Live console

Test a search

Ready /api/search?query=slow%20motion 
Submit a query to preview the JSON response.

Endpoints

All routes

GET /

Home

Documentation homepage and live browser console.

curl "http://localhost:5575/"
Open endpoint
GET /docs

Documentation

Clean browser documentation page with live search testing and every endpoint listed.

curl "http://localhost:5575/docs"
Open endpoint
GET /api

API index

Service metadata, available routes, and example URLs.

curl "http://localhost:5575/api"
Open endpoint
GET /api/ping

Ping

Fast uptime check that does not call the music upstream.

curl "http://localhost:5575/api/ping"
Open endpoint
GET /api/health

Health

Runtime status for uptime checks. Add upstream=true to test the live music upstream. Alias: /health.

curl "http://localhost:5575/api/health?upstream=true"
Open endpoint
GET /health

Health alias

Short alias for /api/health with the same response shape.

curl "http://localhost:5575/health?upstream=true"
Open endpoint
GET /api/search

All search results

Combined search results for songs, albums, playlists, artists, top results, shows, and episodes.

curl "http://localhost:5575/api/search?query=slow%20motion"
Open endpoint
GET /api/summary

Search summary

Compact search response with counts, top result, and a small preview of each category.

curl "http://localhost:5575/api/summary?query=slow%20motion&limit=3"
Open endpoint
GET /api/songs

Songs

Song-only search results with title, artist, image, preview URL, web URL, and language.

curl "http://localhost:5575/api/songs?query=slow%20motion"
Open endpoint
GET /api/albums

Albums

Album-only search results with artwork, title, subtitle, album ID, and web URL.

curl "http://localhost:5575/api/albums?query=slow%20motion"
Open endpoint
GET /api/playlists

Playlists

Playlist-only search results from the upstream autocomplete source.

curl "http://localhost:5575/api/playlists?query=bollywood"
Open endpoint
GET /api/artists

Artists

Artist-only search results with role, image, and web URL.

curl "http://localhost:5575/api/artists?query=arijit%20singh"
Open endpoint
GET /api/top

Top results

Best upstream match for a query. Usually a song, album, artist, or playlist.

curl "http://localhost:5575/api/top?query=slow%20motion"
Open endpoint
GET /api/shows

Shows

Show-only search results when the upstream returns podcast or show matches.

curl "http://localhost:5575/api/shows?query=music"
Open endpoint
GET /api/episodes

Episodes

Episode-only search results when the upstream returns playable episode matches.

curl "http://localhost:5575/api/episodes?query=music"
Open endpoint
GET /api/raw/autocomplete

Raw autocomplete

Unmodified upstream autocomplete JSON for debugging or custom clients.

curl "http://localhost:5575/api/raw/autocomplete?query=slow%20motion"
Open endpoint
GET /api/diagnostics

Deployment diagnostics

Vercel-safe runtime checks for Python, required files, public assets, and route count.

curl "http://localhost:5575/api/diagnostics"
Open endpoint
GET /result/

Legacy result

Compatibility route for older clients from the original JioMusicAPI project.

curl "http://localhost:5575/result/?query=slow%20motion"
Open endpoint