G shnwazdev-GaanaAPI

Unofficial Gaana metadata API

Clean Flask API for songs, albums, search, artwork, lyrics, and health checks.

Every public endpoint is listed in the catalog below. Use the original /result/ route or the newer /api/* endpoints for JSON clients.

Runtime Flask on Vercel
Local port 5555
Response JSON
Version 1.1.0
Endpoints 20

Try a request

Song endpoint tester

GET /result/ Idle 
Run a request to view the JSON response.

Reference

Endpoints

GET /

Clean documentation page with health and API tester.

none Website
GET /docs

Alias for the documentation page.

none Website
GET /styles.css

Stylesheet for the docs page.

none Website
GET /health

Lightweight service health check.

none Core
GET /api/health

API health check alias.

none Core
GET /api

JSON service index with docs and endpoint catalog links.

none Core
GET /api/endpoints

Machine-readable list of every public route.

none Core
GET /api/sample

Static sample song response for frontend testing.

none Core
GET, POST /result/

Original endpoint. Returns an array of song metadata.

url=<gaana-song-url>&lyrics=true Song
GET, POST /api/result

Vercel-style alias for /result/.

url=<gaana-song-url>&lyrics=false Song
GET, POST /api/song

Returns one song object instead of an array.

url=<gaana-song-url> or seokey=<song-seokey> Song
GET /api/song/<seokey>

Fetch one song by Gaana seokey.

lyrics=true Song
GET, POST /api/lyrics

Fetch lyrics for a song when Gaana exposes them.

url=<gaana-song-url> or seokey=<song-seokey> Song
GET /api/lyrics/<seokey>

Fetch lyrics by song seokey.

none Song
GET, POST /api/artwork

Return title and artwork for a song.

url=<gaana-song-url> or seokey=<song-seokey> Song
GET, POST /api/stream

Return stream availability, bitrate, and link when decryptable.

url=<gaana-song-url> or seokey=<song-seokey> Song
GET, POST /api/album

Return album metadata and track list.

url=<gaana-album-url> or seokey=<album-seokey> Album
GET /api/album/<seokey>

Fetch album metadata and tracks by seokey.

lyrics=true Album
GET /api/search

Search Gaana and return normalized results.

q=<query>&type=all|song|album|artist|playlist&limit=10 Discovery
GET, POST /api/resolve

Resolve a Gaana URL into type, seokey, path, and host.

url=<gaana-url> or path=/song/<seokey> Utility

Example

Song

curl "http://localhost:5555/api/song?url=https://gaana.com/song/alone-1435"

Example

Search

curl "http://localhost:5555/api/search?q=alone&type=song&limit=5"

Example

Album

curl "http://localhost:5555/api/album/alone-english-2016-4"

Example

Catalog

curl "http://localhost:5555/api/endpoints"