Skip to main content
GET
/
v1
/
raw
/
youtube
/
channel
/
{handle}
cURL
curl --request GET \
  --url https://api.influship.com/v1/raw/youtube/channel/{handle} \
  --header 'X-API-Key: <api-key>'
import Influship from 'influship';

const client = new Influship({
apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const response = await client.raw.youtube.getChannel('@techreviews');

console.log(response.data);
import os
from influship import Influship

client = Influship(
api_key=os.environ.get("INFLUSHIP_API_KEY"), # This is the default and can be omitted
)
response = client.raw.youtube.get_channel(
handle="@techreviews",
)
print(response.data)
{
  "data": {
    "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
    "handle": "mkbhd",
    "name": "Marques Brownlee",
    "description": "<string>",
    "avatar_url": "<string>",
    "banner_url": "<string>",
    "country": "US",
    "keywords": [
      "<string>"
    ],
    "subscribers": 20900000,
    "subscribers_text": "20.9M subscribers",
    "videos_count": 1500,
    "views_total": 4500000000,
    "videos": [
      {
        "video_id": "dQw4w9WgXcQ",
        "title": "Full Body Workout | 30 Minutes",
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "thumbnail_url": "<string>",
        "published_text": "2 weeks ago",
        "duration_seconds": 1845,
        "duration_text": "30:45",
        "view_count": 125000,
        "view_count_text": "125K views"
      }
    ],
    "scraped_at": "2024-01-15T14:30:00Z"
  }
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"param": "query",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {}
}
}

Authorizations

X-API-Key
string
header
required

Path Parameters

handle
string
required

YouTube channel handle. Accepts a bare handle (techreviews), an @handle (@techreviews), or a full channel URL (https://youtube.com/@techreviews); surrounding share tokens and trailing paths are ignored. A value that is not a channel handle returns a 400 validation error.

Minimum string length: 1
Example:

"@techreviews"

Query Parameters

include_videos
boolean

Include recent videos in response

Example:

true

video_limit
integer
default:12

Number of videos to include

Required range: 1 <= x <= 50
Example:

12

Response

Successful response

data
object
required