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": {}
}
}Live Scraping
Get Live YouTube Channel
Fetch fresh YouTube channel data including subscriber count, video count, and total views.
Pricing: 0.5 credits per channel scraped ($0.005)
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
Path Parameters
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:
1Example:
"@techreviews"
Query Parameters
Include recent videos in response
Example:
true
Number of videos to include
Required range:
1 <= x <= 50Example:
12
Response
Successful response
Show child attributes
Show child attributes
⌘I