YouTube API
Channel Home
Get channel homepage content from YouTube.
POST
$0.01/call/v1/youtube/channelUsage
const res = await fetch('https://api.yepapi.com/v1/youtube/channel', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ id: 'UCAuUUnT6oDeKwE6v1NGQxug' }),
});
const { data } = await res.json();
console.log(data.meta.title, data.data);curl -X POST https://api.yepapi.com/v1/youtube/channel \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"id": "UCAuUUnT6oDeKwE6v1NGQxug"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
id | string | Yes | YouTube channel ID | — |
geo | string | No | Country code for geo-specific results | — |
lang | string | No | Language code | — |
Response
{
"ok": true,
"data": {
"meta": {
"title": "Google for Developers",
"channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
"channelHandle": "@GoogleDevelopers",
"description": "Subscribe to join a community of creative developers and learn the latest in Google technology...",
"subscriberCount": 2620000,
"subscriberCountText": "2.62M",
"videosCount": 6300,
"videosCountText": "6.3K videos",
"isFamilySafe": true,
"isUnlisted": false,
"tabs": ["Home", "Videos", "Shorts", "Live", "Courses", "Playlists", "Posts", "Search"],
"avatar": [{ "url": "https://yt3.ggpht.com/...", "width": 48, "height": 48 }],
"banner": [{ "url": "https://yt3.ggpht.com/...", "width": 1060, "height": 175 }]
},
"data": [
{
"type": "player",
"videoId": "bc5X2iVyJc0",
"title": "Add Gemini Live agents to your video conferencing with Fishjam",
"description": "Adrian from Software Mansion walks through how to connect...",
"viewCount": "3174",
"publishedTimeText": "5 days ago"
},
{
"type": "video_listing",
"title": "AI Tools & Innovations",
"data": [
{
"type": "video",
"videoId": "zEMXCoqJodE",
"title": "AI coding with Gemini CLI",
"lengthText": "38:29",
"viewCount": "40532"
}
]
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.meta | object | Channel metadata |
data.meta.title | string | Channel display name |
data.meta.channelId | string | Unique YouTube channel identifier |
data.meta.channelHandle | string | Channel handle (e.g. @GoogleDevelopers) |
data.meta.description | string | Channel description text |
data.meta.subscriberCount | number | Subscriber count as a number |
data.meta.subscriberCountText | string | Formatted subscriber count (e.g. 2.62M) |
data.meta.videosCount | number | Total number of videos on the channel |
data.meta.videosCountText | string | Formatted video count (e.g. 6.3K videos) |
data.meta.isFamilySafe | boolean | Whether the channel is marked as family-safe |
data.meta.tabs | string[] | Available channel tabs (e.g. Home, Videos, Shorts) |
data.meta.avatar | object[] | Channel profile picture at various sizes |
data.meta.banner | object[] | Channel banner images at various sizes |
data.data | object[] | Channel homepage content sections |
data.data[].type | string | Section type: player, video_listing, shorts_listing |
data.data[].title | string | Section or video title |
data.data[].videoId | string | Video identifier (for player type) |
data.data[].data | object[] | Nested video items (for video_listing type) |