YOUTUBE API
Channel Videos
Retrieve channel videos from YouTube with a single API request.
GET
/api/data/v1/youtube/channel-videos1credit base cost
Request parameters
Up to 1 creditYouTube channel ID
YouTube channel handle
Sort by latest or popular
This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. Honestly, if you use this param, the error rate is higher. We might deprecate this param in the future
Continuation token to get more videos. Get 'continuationToken' from previous response.
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/youtube/channel-videos?handle=ThePatMcAfeeShow' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"videos": [
{
"type": "video",
"id": "5EWaxmWgQMI",
"url": "https://www.youtube.com/watch?v=5EWaxmWgQMI",
"title": "Russell Wilson Hopes To Finish Career As A Steeler, Reflects On NFL Career With Pat McAfee",
"description": "Welcome to The Pat McAfee Show LIVE from Noon-3PM EST Mon-Fri. You can also find us live on ESPN, ESPN+, & TikTok!\n\nBecome a #McAfeeMafia member! https://www.youtube.com/channel/UCxcTeAKWJca6XyJ37_...",
"thumbnail": "https://i.ytimg.com/vi/5EWaxmWgQMI/hqdefault.jpg?sqp=-oaymwEnCNACELwBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBZIBEJGcYDrduIZJpaSmYHcIHJ6g",
"channel": {
"title": "",
"thumbnail": null
},
"viewCountText": "110,447 views",
"viewCountInt": 110447,
"publishedTimeText": "9 days ago",
"publishedTime": "2025-01-23T22:48:53.914Z",
"lengthText": "37:25",
"lengthSeconds": 2245,
"badges": []
}
],
"continuationToken": "4qmFsgLlFhIYV....",
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"thumbnail": {
"type": "string"
},
"channel": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"thumbnail": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
}
},
"viewCountText": {
"type": "string"
},
"viewCountInt": {
"type": "integer"
},
"publishedTimeText": {
"type": "string"
},
"publishedTime": {
"type": "string"
},
"lengthText": {
"type": "string"
},
"lengthSeconds": {
"type": "integer"
},
"badges": {
"type": "array"
}
}
}
},
"continuationToken": {
"type": "string"
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}