DOCUMENTATION

PlaylistAPI

A simple and powerful API for accessing music, playlist, artist and track data.

Base URL

https://api.playlistapi.com/v1

PlaylistAPI provides a RESTful interface that returns clean and predictable JSON responses.

Authentication

Every API request requires a valid API key. You can create and manage your API keys from your dashboard.

Request 
curl https://api.playlistapi.com/v1/playlists

  -H "Authorization: Bearer YOUR_API_KEY"

Keep your API key private. Never expose it in client-side JavaScript or public repositories.

Quickstart

Make your first request in seconds.

GET /v1/playlists
JavaScript 
const response =
  await fetch(
    'https://api.playlistapi.com/v1/playlists',
    {
      headers: {
        'Authorization':
          'Bearer YOUR_API_KEY'
      }
    }
  );

const data =
  await response.json();

console.log(data);

Playlists

Retrieve playlist information and its tracks.

GET /v1/playlists/{id}

Path Parameters

Parameter Type Required
id string Yes

Tracks

Get information about a specific track.

GET /v1/tracks/{id}

Artists

Retrieve artist information and related music.

GET /v1/artists/{id}

Albums

Retrieve album metadata and track listings.

GET /v1/albums/{id}

Rate Limits

API rate limits depend on your subscription plan. Requests exceeding your limit return HTTP status 429 Too Many Requests.

Errors

PlaylistAPI uses standard HTTP status codes to indicate whether a request succeeded or failed.

Code Meaning
400 Bad Request
401 Unauthorized
404 Resource Not Found
429 Rate Limit Exceeded
500 Internal Server Error

Changelog

Version 1.0 — Initial public API release.