Youtube
YouTube: channels, videos, shorts, live streams, comments, search, trending, hashtags.
Returns channel details. Provide exactly one of id, handle, or channelUrl.
Cost: 150 credits/request + 1 credit/item
@MrBeastSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/channel HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "channel",
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"name": "MrBeast",
"handle": "@MrBeast",
"url": "http://www.youtube.com/@MrBeast",
"description": "SUBSCRIBE FOR A COOKIE!",
"thumbnails": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE",
"isFamilySafe": true,
"subscriberCount": "421M subscribers",
"availableCountries": [
"US",
"GB",
"CA"
],
"tags": [
"mrbeast",
"beast"
],
"joinedAt": "Joined Feb 20, 2012",
"viewCount": "87,234,567,890 views",
"videoCount": 837
}
],
"pricing": {
"creditsCharged": 151
}
}Returns videos uploaded by the channel. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Cost: 150 credits/request + 1 credit/item
UCX6OQ3DkcsbYNE6H8uQQuVASuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/channel/{id}/videos HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "EerdGm-ehJQ",
"url": "https://www.youtube.com/watch?v=EerdGm-ehJQ",
"title": "JavaScript Tutorial Full Course - Beginner to Pro",
"description": "Get a certificate for this course",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"richThumbnail": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"publishDate": "1 year ago",
"views": "8531468",
"duration": "22:15:57"
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"creditsCharged": 151
}
}Returns shorts uploaded by the channel. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Cost: 150 credits/request + 1 credit/item
UCX6OQ3DkcsbYNE6H8uQQuVASuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/channel/{id}/shorts HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "EerdGm-ehJQ",
"url": "https://www.youtube.com/watch?v=EerdGm-ehJQ",
"title": "JavaScript Tutorial Full Course - Beginner to Pro",
"description": "Get a certificate for this course",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"richThumbnail": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"publishDate": "1 year ago",
"views": "8531468",
"duration": "22:15:57"
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"creditsCharged": 151
}
}Returns live streams (current and past) for the channel. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Cost: 200 credits/request + 1 credit/item
UCX6OQ3DkcsbYNE6H8uQQuVASuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/channel/{id}/live-streams HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "EerdGm-ehJQ",
"url": "https://www.youtube.com/watch?v=EerdGm-ehJQ",
"title": "JavaScript Tutorial Full Course - Beginner to Pro",
"description": "Get a certificate for this course",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"richThumbnail": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"publishDate": "1 year ago",
"views": "8531468",
"duration": "22:15:57"
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"creditsCharged": 201
}
}Returns full metadata for a single video by its 11-character video id.
Cost: 150 credits/request + 1 credit/item
dQw4w9WgXcQSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/video?id=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
"status": "OK",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"description": "The official video for \"Never Gonna Give You Up\" by Rick Astley.",
"duration": 213,
"views": 1766758607,
"likes": 18978439,
"comments": 2400000,
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"keywords": [
"rick astley",
"Never Gonna Give You Up"
],
"superTitle": "#RickAstley #NeverGonnaGiveYouUp #OfficialMusicVideo",
"category": "Music",
"isRatingsAllowed": true,
"isLive": false,
"isFamilySafe": true,
"isPrivate": false,
"isExclusive": false,
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
}
],
"pricing": {
"creditsCharged": 151
}
}Returns full metadata for a single short by its video id.
Cost: 200 credits/request + 1 credit/item
dQw4w9WgXcQSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/shorts/{id} HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
"status": "OK",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"description": "The official video for \"Never Gonna Give You Up\" by Rick Astley.",
"duration": 213,
"views": 1766758607,
"likes": 18978439,
"comments": 2400000,
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"keywords": [
"rick astley",
"Never Gonna Give You Up"
],
"superTitle": "#RickAstley #NeverGonnaGiveYouUp #OfficialMusicVideo",
"category": "Music",
"isRatingsAllowed": true,
"isLive": false,
"isFamilySafe": true,
"isPrivate": false,
"isExclusive": false,
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
}
],
"pricing": {
"creditsCharged": 201
}
}Returns top-level comments for a video. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive). sort is top (default) or latest.
Cost: 10 credits/request + 1 credit/item
dQw4w9WgXcQSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/comments?id=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "comment",
"id": "UgwJsXlCbEu8-5nIK3h4AaABAg",
"text": "Check out the latest Space Souvenirs Drop on the kurzgesagt shop",
"likeCount": "1.8K",
"replyCount": "59",
"publishedTime": "1 month ago",
"author": {
"id": "UCsXVk37bltHxD1rDPwtNM8Q",
"name": "@kurzgesagt",
"thumbnails": "https://yt3.ggpht.com/ytc/AIdro_n1Ribd7LwdP_qKtqWL3ZDfIgv9M1d6g78VwpHGXVR2Ir4=s88-c-k-c0x00ffffff-no-rj"
}
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"creditsCharged": 11
}
}Search YouTube. mode selects what to search for (video, channel, or playlist). When mode=video results match YoutubeVideo; other modes return shape variants. Use cursor to paginate or maxItems for a one-shot bulk pull (mutually exclusive).
Cost: 150 credits/request + 1 credit/item
javascriptvideoPossible values: Successful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/search?query=text&mode=video HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "EerdGm-ehJQ",
"url": "https://www.youtube.com/watch?v=EerdGm-ehJQ",
"title": "JavaScript Tutorial Full Course - Beginner to Pro",
"description": "Get a certificate for this course",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"richThumbnail": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"publishDate": "1 year ago",
"views": "8531468",
"duration": "22:15:57"
}
],
"pagination": {
"page": 1,
"hasNextPage": null,
"cursor": null,
"offset": null
},
"pricing": {
"creditsCharged": 151
}
}Returns videos tagged with tag from a single request.
Cost: 150 credits/request + 1 credit/item
musicSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/hashtag?tag=text HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "EerdGm-ehJQ",
"url": "https://www.youtube.com/watch?v=EerdGm-ehJQ",
"title": "JavaScript Tutorial Full Course - Beginner to Pro",
"description": "Get a certificate for this course",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"richThumbnail": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"publishDate": "1 year ago",
"views": "8531468",
"duration": "22:15:57"
}
],
"pricing": {
"creditsCharged": 151
}
}Returns currently trending videos. Use geo to target a country (e.g. US, GB).
Cost: 250 credits/request + 1 credit/item
USSuccessful request
3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24200OKtrueBad request
Insufficient credits
Not found
GET /youtube/trending HTTP/1.1
Host: api.pullbay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"requestId": "3b8dcb68-1f8c-4a7b-b9e7-63a7b9986f24",
"status": 200,
"message": "OK",
"success": true,
"data": [
{
"type": "video",
"id": "EerdGm-ehJQ",
"url": "https://www.youtube.com/watch?v=EerdGm-ehJQ",
"title": "JavaScript Tutorial Full Course - Beginner to Pro",
"description": "Get a certificate for this course",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"richThumbnail": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
],
"channel": {
"id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"name": "Rick Astley",
"handle": "@RickAstleyYT",
"url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
"subscriberCount": "4.49M subscribers",
"badges": [
"Official Artist Channel"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"width": 480,
"height": 360
}
]
},
"publishDate": "1 year ago",
"views": "8531468",
"duration": "22:15:57"
}
],
"pricing": {
"creditsCharged": 251
}
}Last updated