> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velora.crickdevs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Practical cURL examples for common Velora API operations.

Use `x-api-key` in every request shown here.

## List songs

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/songs?page=1&limit=20"
```

## Get a song by id

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/songs/SONG_ID"
```

## Get trending songs

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/songs/trending?limit=10"
```

## List playlists

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/playlists?page=1&limit=20"
```

## Playlist details

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/playlists/PLAYLIST_ID"
```

## Playlist songs

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/playlists/PLAYLIST_ID/songs?page=1&limit=20"
```

## List artists

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/artists?page=1&limit=20"
```

## Artist details by username or id

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/artists/USERNAME_OR_ID"
```

## Public user profile

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://api.velora.crickdevs.com/api/users/USERNAME"
```