Music API

API for retrieving music details: Artists, Albums, and Tracks

Music API Documentation

A Music API is like a backstage pass to the world of music, providing access to song data, streaming and more. It's the key ingredient for building music-related apps and services, from personalized music discovery to social music platforms.

Base URL

The base URL for the Music API is:

https://santechapi.vercel.app

Authentication

headers : {
"token" : {YOUR API KEY}
}

Endpoint: /music

HTTP Method: GET

Example Request:

GET /music 

Example Response:

200

[
	{
		"_id": "65133753b294a6e1ecde344e",
		"name": "Thee Thalapathy",
		"artist": "Silambarasan T R",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/theethalapathy.jpg",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Thee%20Thalapathy.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3453",
		"name": "Vaathi Coming",
		"artist": "Anirudh Ravichander",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/vaathicoming.jpg",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Vaathi%20Coming.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde344d",
		"name": "Chilla Chilla",
		"artist": "Vaisagh",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/chilachila.jpg",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/chilachila.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3455",
		"name": "Baby",
		"artist": "Justin Bieber",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/baby.jpg",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/baby.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3457",
		"name": "Mehabooba",
		"artist": "Ananya Bhat",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/mehabooba.jpg",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Mehabooba.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde345c",
		"name": "Marakavillaye",
		"artist": "Darshan Raval",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/needapadadhani.jpg",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/marakavillaye.mp3"
	}
]

The response includes the music ID, name, artist, audio and image.

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

Example Error Response:

400

{
message: "Error retrieving the music documents"
}

Endpoint: /music/name

Example Request:

GET /music/name 

Example Response:

200

[
	{
		"_id": "65133753b294a6e1ecde344d",
		"name": "Chilla Chilla"
	},
	{
		"_id": "65133753b294a6e1ecde344e",
		"name": "Thee Thalapathy"
	},
	{
		"_id": "65133753b294a6e1ecde344f",
		"name": "Vaa Vaathi"
	},
	{
		"_id": "65133753b294a6e1ecde3450",
		"name": "Porkanda Singam"
	},
	{
		"_id": "65133753b294a6e1ecde3451",
		"name": "DaDa"
	},
	{
		"_id": "65133753b294a6e1ecde3452",
		"name": "Ennai Vittu"
	},
	{
		"_id": "65133753b294a6e1ecde3453",
		"name": "Vaathi Coming"
	},
	{
		"_id": "65133753b294a6e1ecde3454",
		"name": "Ranjithame"
	},
	{
		"_id": "65133753b294a6e1ecde3455",
		"name": "Baby"
	},
	{
		"_id": "65133753b294a6e1ecde3456",
		"name": "Darshana"
	},
	{
		"_id": "65133753b294a6e1ecde3457",
		"name": "Mehabooba"
	},
	{
		"_id": "65133753b294a6e1ecde3458",
		"name": "Malare"
	},
	{
		"_id": "65133753b294a6e1ecde3459",
		"name": "Kudukku"
	},
	{
		"_id": "65133753b294a6e1ecde345a",
		"name": "Vaathil Melle"
	},
	{
		"_id": "65133753b294a6e1ecde345b",
		"name": "Dooreyo"
	},
	{
		"_id": "65133753b294a6e1ecde345c",
		"name": "Marakavillaye"
	},
	{
		"_id": "65133753b294a6e1ecde345d",
		"name": "Samajavaragamana"
	},
	{
		"_id": "65133753b294a6e1ecde345e",
		"name": "Oo Antava Oo Oo Antava"
	},
	{
		"_id": "65133753b294a6e1ecde345f",
		"name": "Pila Padesaave"
	},
	{
		"_id": "65133753b294a6e1ecde3460",
		"name": "Oh Sita Hey Rama"
	},
	{
		"_id": "65133753b294a6e1ecde3461",
		"name": "On My Way"
	},
	{
		"_id": "65133753b294a6e1ecde3462",
		"name": "Thunder"
	},
	{
		"_id": "65133753b294a6e1ecde3463",
		"name": "Shape Of You"
	},
	{
		"_id": "65133753b294a6e1ecde3464",
		"name": "Heat Waves"
	},
	{
		"_id": "65133753b294a6e1ecde3465",
		"name": "Friends"
	},
	{
		"_id": "65133753b294a6e1ecde3466",
		"name": "Favorite Song"
	},
	{
		"_id": "6513ca99f642d100080c4509",
		"name": "Naa Ready"
	}
]

The response includes the music ID and name

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

Example Error Response:

400

{
message: "Error retrieving the titles"
}

Endpoint: /music/images

Example Request:

GET /music/images

Example Response:

200

[
	{
		"_id": "65133753b294a6e1ecde344d",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/chilachila.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde344e",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/theethalapathy.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde344f",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/vaavathi.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3450",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/porkondasingam.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3451",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/dada.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3452",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/ennaivitu.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3453",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/vaathicoming.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3454",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/ranjithame.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3455",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/baby.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3456",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/darshana.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3457",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/mehabooba.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3458",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/malare.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3459",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/kudukku.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde345a",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/vaathilmelle.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde345b",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/dooreyo.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde345c",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/needapadadhani.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde345d",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/samajavaragamana.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde345e",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/ooantavaooooantava.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde345f",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/pilapadesaave.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3460",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/ohsitaheyrama.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3461",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/onmyway.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3462",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/thunder.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3463",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/shapeofyou.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3464",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/heatwaves.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3465",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/friends.jpg"
	},
	{
		"_id": "65133753b294a6e1ecde3466",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/needapadadhani.jpg"
	},
	{
		"_id": "6513ca99f642d100080c4509",
		"img": "https://ik.imagekit.io/vituepzjm/EESAI/vaavathi.jpg"
	}
]

The response includes the music ID and images

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

Example Error Response:

{
message: "Error retrieving the images"
}

Endpoint: /music/images

Example Request:

GET /music/audio

Example Response:

200

[
	{
		"_id": "65133753b294a6e1ecde344d",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/chilachila.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde344e",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Thee%20Thalapathy.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde344f",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Vaa%20Vaathi.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3450",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Porkanda%20Singam.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3451",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/DADA%20Song.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3452",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Ennai%20Vittu.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3453",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Vaathi%20Coming.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3454",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Ranjithame.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3455",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/baby.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3456",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/darshana.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3457",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Mehabooba.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3458",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/malare.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3459",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/kudukku.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde345a",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/vaathilmelle.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde345b",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Dooreyo.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde345c",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/marakavillaye.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde345d",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Samajavaragamana.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde345e",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Oo%20Antava%20Oo%20Oo%20Antava.mp?updatedAt=1695754794081"
	},
	{
		"_id": "65133753b294a6e1ecde345f",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Pila%20Padesaave.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3460",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Oh%20Sita%20Hey%20Rama.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3461",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/On%20My%20Way.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3462",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Thunder.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3463",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Shape%20Of%20You.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3464",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Heat%20Waves.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3465",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Friends.mp3"
	},
	{
		"_id": "65133753b294a6e1ecde3466",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/marakavillaye.mp3"
	},
	{
		"_id": "6513ca99f642d100080c4509",
		"audio": "https://ik.imagekit.io/vituepzjm/EESAI/Songs/Vaa%20Vaathi.mp3?updatedAt=1695621528155"
	}
]

The response includes the music ID and Audio

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

Example Error Response:

400

{
message: "Error retrieving the audio"
}