Skip to main content
GET
https://api.scriptbase.app
/
api
/
v1
/
playlists
/
{id}
curl "https://api.scriptbase.app/api/v1/playlists/PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
  -H "X-API-Key: sk_your_key_here"
{
  "success": true,
  "data": {
    "id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
    "title": "JavaScript Tutorials",
    "description": "Learn JavaScript from beginner to advanced...",
    "thumbnail": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg",
    "videoCount": 42,
    "channel": {
      "id": "UCW5YeuERMmlnqo4oq8vGKAg",
      "name": "Fireship"
    },
    "publishedAt": "2020-05-15T00:00:00.000Z"
  },
  "meta": {
    "creditsUsed": 1,
    "creditsRemaining": 999,
    "rateLimit": {
      "limit": 60,
      "remaining": 59,
      "resetAt": 1704326400
    }
  }
}

Overview

Get information about a YouTube playlist including title, description, channel info, and video count.

Authentication

X-API-Key
string
required
Your API key

Path Parameters

id
string
required
YouTube playlist ID (starts with PL) or full playlist URL

Credits

  • Cost: 1 credit per request

Response

success
boolean
Whether the request was successful
data
object
meta
object
curl "https://api.scriptbase.app/api/v1/playlists/PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" \
  -H "X-API-Key: sk_your_key_here"
{
  "success": true,
  "data": {
    "id": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
    "title": "JavaScript Tutorials",
    "description": "Learn JavaScript from beginner to advanced...",
    "thumbnail": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg",
    "videoCount": 42,
    "channel": {
      "id": "UCW5YeuERMmlnqo4oq8vGKAg",
      "name": "Fireship"
    },
    "publishedAt": "2020-05-15T00:00:00.000Z"
  },
  "meta": {
    "creditsUsed": 1,
    "creditsRemaining": 999,
    "rateLimit": {
      "limit": 60,
      "remaining": 59,
      "resetAt": 1704326400
    }
  }
}

Error Codes

StatusCodeDescription
400INVALID_INPUTInvalid playlist ID format
401INVALID_API_KEYAPI key is missing or invalid
404NOT_FOUNDPlaylist not found or private
429QUOTA_EXCEEDEDMonthly quota exhausted
429RATE_LIMIT_EXCEEDEDToo many requests