Logo

Docs

Endpoints

Search songs

Search songs by name, artist, album, or ISRC

GET
/songs

Query Parameters

q?string

Search query for song name

artist?string

Filter by artist name

album?string

Filter by album name

isrc?string

Filter by ISRC code

limit?integer
Default20
Range1 <= value <= 100
offset?integer
Default0
Range0 <= value

Response Body

application/json

curl -X GET "https://api.vleer.app/metadata/songs"
{
  "data": [
    {
      "id": "string",
      "name": "string",
      "album_name": "string",
      "artist_name": "string",
      "artwork_url": "http://example.com",
      "disc_number": 0,
      "duration_seconds": 0,
      "isrc": "string",
      "release_date": "string",
      "track_number": 0
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}