# Music API
## 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"
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://santech.gitbook.io/docs/music-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.