Skip to main content
GET
https://api.scriptbase.app
/
api
/
v1
/
channels
/
{id}
curl "https://api.scriptbase.app/api/v1/channels/UCuAXFkgsw1L7xaCfnd5JJOw" \
  -H "X-API-Key: sk_your_key_here"
{
  "success": true,
  "data": {
    "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "name": "Rick Astley",
    "description": "Official YouTube channel for Rick Astley...",
    "subscriberCount": 3500000,
    "videoCount": 85,
    "viewCount": 2500000000,
    "thumbnail": "https://yt3.ggpht.com/...",
    "banner": "https://yt3.googleusercontent.com/...",
    "customUrl": "@RickAstleyYT",
    "country": "GB",
    "publishedAt": "2006-09-08T00:00:00.000Z"
  },
  "meta": {
    "creditsUsed": 1,
    "creditsRemaining": 999,
    "rateLimit": {
      "limit": 60,
      "remaining": 59,
      "resetAt": 1704326400
    }
  }
}

Overview

Get detailed information about a YouTube channel including name, description, subscriber count, video count, and other statistics.

Authentication

X-API-Key
string
required
Your API key

Path Parameters

id
string
required
YouTube channel ID (starts with UC), handle (@username), or channel 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/channels/UCuAXFkgsw1L7xaCfnd5JJOw" \
  -H "X-API-Key: sk_your_key_here"
{
  "success": true,
  "data": {
    "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "name": "Rick Astley",
    "description": "Official YouTube channel for Rick Astley...",
    "subscriberCount": 3500000,
    "videoCount": 85,
    "viewCount": 2500000000,
    "thumbnail": "https://yt3.ggpht.com/...",
    "banner": "https://yt3.googleusercontent.com/...",
    "customUrl": "@RickAstleyYT",
    "country": "GB",
    "publishedAt": "2006-09-08T00:00:00.000Z"
  },
  "meta": {
    "creditsUsed": 1,
    "creditsRemaining": 999,
    "rateLimit": {
      "limit": 60,
      "remaining": 59,
      "resetAt": 1704326400
    }
  }
}

Error Codes

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