YouTube channel
curl --request POST \
--url https://api.neuralverge.ai/functions/v1/run-youtube-channel \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "@NASA",
"max_results": 2
}
'import requests
url = "https://api.neuralverge.ai/functions/v1/run-youtube-channel"
payload = {
"url": "@NASA",
"max_results": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: '@NASA', max_results: 2})
};
fetch('https://api.neuralverge.ai/functions/v1/run-youtube-channel', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.neuralverge.ai/functions/v1/run-youtube-channel",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'url' => '@NASA',
'max_results' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.neuralverge.ai/functions/v1/run-youtube-channel"
payload := strings.NewReader("{\n \"url\": \"@NASA\",\n \"max_results\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.neuralverge.ai/functions/v1/run-youtube-channel")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"@NASA\",\n \"max_results\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neuralverge.ai/functions/v1/run-youtube-channel")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"@NASA\",\n \"max_results\": 2\n}"
response = http.request(request)
puts response.read_body{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "youtube_channel",
"url": "https://www.youtube.com/@NASA",
"sort_videos_by": "",
"max_results": 2,
"max_results_shorts": 0,
"max_results_streams": 0,
"download_subtitles": false,
"subtitles_language": "en",
"subtitles_format": "srt",
"partial": false,
"human": "# YouTube channel\n\n- **Source:** @NASA\n- **Limits:** 2 videos, 0 shorts, 0 streams\n- **Records returned:** 2\n- **NASA:** @NASA · 15M subscribers · 6,194 videos · verified",
"machine": {
"total_items": 2,
"items": [
{
"id": "5b3n-u_0QAI",
"url": "https://www.youtube.com/watch?v=5b3n-u_0QAI",
"type": "video",
"title": "Planetary Defenders: This Is Not an Exercise",
"translated_title": null,
"description": "When a newly discovered asteroid posed a potential risk to Earth, a global planetary defense system was put to the test like never before. Planetary Defenders: This Is Not an Exercise tells the story ",
"description_links": [
{
"text": "https://science.nasa.gov/planetary-de...",
"url": "https://science.nasa.gov/planetary-defense/"
},
{
"text": "https://images.nasa.gov/details/NHQ_2...",
"url": "https://images.nasa.gov/details/NHQ_2026_0928_Planetary%20Defenders%20This%20Is%20Not%20an%20Exercise"
},
{
"text": "• Planetary Defenders (NASA+ Original Docume...",
"url": "https://www.youtube.com/watch?v=jOb2DQWvDvc"
}
],
"hashtags": [],
"date": "2026-10-14T15:05:17.000Z",
"duration": "00:20:15",
"view_count": 649889,
"likes": 11000,
"comments_count": 0,
"comments_turned_off": false,
"thumbnail_url": "https://i.ytimg.com/vi/5b3n-u_0QAI/maxresdefault.jpg",
"location": null,
"is_monetized": null,
"is_members_only": false,
"is_paid_content": false,
"is_age_restricted": false,
"collaborators": [],
"subtitles": [],
"channel": {
"id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"name": "NASA",
"username": "NASA",
"url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
"subscribers": 15100000,
"total_videos": 6194,
"total_views": 1132208768,
"description": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research. To do that, we have worked around the world—and off it—for more than 60 years, searching f",
"description_links": [
{
"text": "nasa.gov",
"url": "https://www.nasa.gov"
},
{
"text": "X",
"url": "https://x.com/nasa"
},
{
"text": "Facebook",
"url": "https://www.facebook.com/NASA"
}
],
"location": null,
"joined_date": "Jun 3, 2008",
"is_verified": true,
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj",
"banner_url": "https://yt3.googleusercontent.com/y8Srh-oCcilLvBO8jAPI546m1bn0puA5DIvQiBZ1cSxc_rZfKxKSFlTCtoCQCtB6viUf1NGsaQ=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj"
},
"order": 1,
"found_on_url": "https://www.youtube.com/@NASA/videos",
"source": "https://www.youtube.com/@NASA"
},
{
"id": "Zezt6EsG9WE",
"url": "https://www.youtube.com/watch?v=Zezt6EsG9WE",
"type": "video",
"title": "NASA Moon Base: Rovers and Lunar Terrain Vehicles (October 2026 Update)",
"translated_title": null,
"description": "There's a lot of ground to cover when you're building a Moon Base. From robotic rovers exploring the rugged lunar landscape to lunar terrain vehicles carrying Artemis astronauts across the surface, mo",
"description_links": [
{
"text": "https://www.nasa.gov/missions/moon-ba...",
"url": "https://www.nasa.gov/missions/moon-base/nasa-provides-progress-update-on-moon-base-rovers/"
},
{
"text": "https://www.nasa.gov/moonbase/",
"url": "https://www.nasa.gov/moonbase/"
},
{
"text": "0:00",
"url": "https://www.youtube.com/watch?v=Zezt6EsG9WE"
}
],
"hashtags": [],
"date": "2026-10-20T15:02:15.000Z",
"duration": "00:09:17",
"view_count": 894497,
"likes": 10000,
"comments_count": 0,
"comments_turned_off": false,
"thumbnail_url": "https://i.ytimg.com/vi/Zezt6EsG9WE/maxresdefault.jpg",
"location": null,
"is_monetized": null,
"is_members_only": false,
"is_paid_content": false,
"is_age_restricted": false,
"collaborators": [],
"subtitles": [],
"channel": {
"id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"name": "NASA",
"username": "NASA",
"url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
"subscribers": 15100000,
"total_videos": 6194,
"total_views": 1132208768,
"description": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research. To do that, we have worked around the world—and off it—for more than 60 years, searching f",
"description_links": [
{
"text": "nasa.gov",
"url": "https://www.nasa.gov"
},
{
"text": "X",
"url": "https://x.com/nasa"
},
{
"text": "Facebook",
"url": "https://www.facebook.com/NASA"
}
],
"location": null,
"joined_date": "Jun 3, 2008",
"is_verified": true,
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj",
"banner_url": "https://yt3.googleusercontent.com/y8Srh-oCcilLvBO8jAPI546m1bn0puA5DIvQiBZ1cSxc_rZfKxKSFlTCtoCQCtB6viUf1NGsaQ=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj"
},
"order": 0,
"found_on_url": "https://www.youtube.com/@NASA/videos",
"source": "https://www.youtube.com/@NASA"
}
],
"errors": []
},
"total_points": 10
}Social media
YouTube channel
Get the videos, shorts and streams of a YouTube channel or playlist (or a single video by URL): title, description, views, likes, comments, duration, hashtags, subtitles and the channel’s subscribers, total videos and views. 5 point per returned record.
POST
/
functions
/
v1
/
run-youtube-channel
YouTube channel
curl --request POST \
--url https://api.neuralverge.ai/functions/v1/run-youtube-channel \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "@NASA",
"max_results": 2
}
'import requests
url = "https://api.neuralverge.ai/functions/v1/run-youtube-channel"
payload = {
"url": "@NASA",
"max_results": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: '@NASA', max_results: 2})
};
fetch('https://api.neuralverge.ai/functions/v1/run-youtube-channel', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.neuralverge.ai/functions/v1/run-youtube-channel",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'url' => '@NASA',
'max_results' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.neuralverge.ai/functions/v1/run-youtube-channel"
payload := strings.NewReader("{\n \"url\": \"@NASA\",\n \"max_results\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.neuralverge.ai/functions/v1/run-youtube-channel")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"@NASA\",\n \"max_results\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.neuralverge.ai/functions/v1/run-youtube-channel")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"@NASA\",\n \"max_results\": 2\n}"
response = http.request(request)
puts response.read_body{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "youtube_channel",
"url": "https://www.youtube.com/@NASA",
"sort_videos_by": "",
"max_results": 2,
"max_results_shorts": 0,
"max_results_streams": 0,
"download_subtitles": false,
"subtitles_language": "en",
"subtitles_format": "srt",
"partial": false,
"human": "# YouTube channel\n\n- **Source:** @NASA\n- **Limits:** 2 videos, 0 shorts, 0 streams\n- **Records returned:** 2\n- **NASA:** @NASA · 15M subscribers · 6,194 videos · verified",
"machine": {
"total_items": 2,
"items": [
{
"id": "5b3n-u_0QAI",
"url": "https://www.youtube.com/watch?v=5b3n-u_0QAI",
"type": "video",
"title": "Planetary Defenders: This Is Not an Exercise",
"translated_title": null,
"description": "When a newly discovered asteroid posed a potential risk to Earth, a global planetary defense system was put to the test like never before. Planetary Defenders: This Is Not an Exercise tells the story ",
"description_links": [
{
"text": "https://science.nasa.gov/planetary-de...",
"url": "https://science.nasa.gov/planetary-defense/"
},
{
"text": "https://images.nasa.gov/details/NHQ_2...",
"url": "https://images.nasa.gov/details/NHQ_2026_0928_Planetary%20Defenders%20This%20Is%20Not%20an%20Exercise"
},
{
"text": "• Planetary Defenders (NASA+ Original Docume...",
"url": "https://www.youtube.com/watch?v=jOb2DQWvDvc"
}
],
"hashtags": [],
"date": "2026-10-14T15:05:17.000Z",
"duration": "00:20:15",
"view_count": 649889,
"likes": 11000,
"comments_count": 0,
"comments_turned_off": false,
"thumbnail_url": "https://i.ytimg.com/vi/5b3n-u_0QAI/maxresdefault.jpg",
"location": null,
"is_monetized": null,
"is_members_only": false,
"is_paid_content": false,
"is_age_restricted": false,
"collaborators": [],
"subtitles": [],
"channel": {
"id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"name": "NASA",
"username": "NASA",
"url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
"subscribers": 15100000,
"total_videos": 6194,
"total_views": 1132208768,
"description": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research. To do that, we have worked around the world—and off it—for more than 60 years, searching f",
"description_links": [
{
"text": "nasa.gov",
"url": "https://www.nasa.gov"
},
{
"text": "X",
"url": "https://x.com/nasa"
},
{
"text": "Facebook",
"url": "https://www.facebook.com/NASA"
}
],
"location": null,
"joined_date": "Jun 3, 2008",
"is_verified": true,
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj",
"banner_url": "https://yt3.googleusercontent.com/y8Srh-oCcilLvBO8jAPI546m1bn0puA5DIvQiBZ1cSxc_rZfKxKSFlTCtoCQCtB6viUf1NGsaQ=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj"
},
"order": 1,
"found_on_url": "https://www.youtube.com/@NASA/videos",
"source": "https://www.youtube.com/@NASA"
},
{
"id": "Zezt6EsG9WE",
"url": "https://www.youtube.com/watch?v=Zezt6EsG9WE",
"type": "video",
"title": "NASA Moon Base: Rovers and Lunar Terrain Vehicles (October 2026 Update)",
"translated_title": null,
"description": "There's a lot of ground to cover when you're building a Moon Base. From robotic rovers exploring the rugged lunar landscape to lunar terrain vehicles carrying Artemis astronauts across the surface, mo",
"description_links": [
{
"text": "https://www.nasa.gov/missions/moon-ba...",
"url": "https://www.nasa.gov/missions/moon-base/nasa-provides-progress-update-on-moon-base-rovers/"
},
{
"text": "https://www.nasa.gov/moonbase/",
"url": "https://www.nasa.gov/moonbase/"
},
{
"text": "0:00",
"url": "https://www.youtube.com/watch?v=Zezt6EsG9WE"
}
],
"hashtags": [],
"date": "2026-10-20T15:02:15.000Z",
"duration": "00:09:17",
"view_count": 894497,
"likes": 10000,
"comments_count": 0,
"comments_turned_off": false,
"thumbnail_url": "https://i.ytimg.com/vi/Zezt6EsG9WE/maxresdefault.jpg",
"location": null,
"is_monetized": null,
"is_members_only": false,
"is_paid_content": false,
"is_age_restricted": false,
"collaborators": [],
"subtitles": [],
"channel": {
"id": "UCLA_DiR1FfKNvjuUpBHmylQ",
"name": "NASA",
"username": "NASA",
"url": "https://www.youtube.com/channel/UCLA_DiR1FfKNvjuUpBHmylQ",
"subscribers": 15100000,
"total_videos": 6194,
"total_views": 1132208768,
"description": "NASA's mission is to pioneer the future in space exploration, scientific discovery, and aeronautics research. To do that, we have worked around the world—and off it—for more than 60 years, searching f",
"description_links": [
{
"text": "nasa.gov",
"url": "https://www.nasa.gov"
},
{
"text": "X",
"url": "https://x.com/nasa"
},
{
"text": "Facebook",
"url": "https://www.facebook.com/NASA"
}
],
"location": null,
"joined_date": "Jun 3, 2008",
"is_verified": true,
"avatar_url": "https://yt3.googleusercontent.com/eIf5fNPcIcj9ig-wZBeq4stFy1lgjWTW1nLT5dYlFkHZprZ03QBiMcbpwNMB6XSBjrSFGtAGQg=s68-c-k-c0x00ffffff-no-rj",
"banner_url": "https://yt3.googleusercontent.com/y8Srh-oCcilLvBO8jAPI546m1bn0puA5DIvQiBZ1cSxc_rZfKxKSFlTCtoCQCtB6viUf1NGsaQ=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj"
},
"order": 0,
"found_on_url": "https://www.youtube.com/@NASA/videos",
"source": "https://www.youtube.com/@NASA"
}
],
"errors": []
},
"total_points": 10
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Channel (@handle or URL), playlist or video URL. e.g. @NASA
Videos (up to 1000)
Required range:
0 <= x <= 1000Shorts (up to 1000)
Required range:
0 <= x <= 1000Streams (up to 1000)
Required range:
0 <= x <= 1000Sort channel videos by. Options: POPULAR = Popular, OLDEST = Oldest
Available options:
POPULAR, OLDEST Download subtitles (when present on the video)
Subtitle language. Options: any = Any, de = German, es = Spanish, fr = French, it = Italian, ja = Japanese, ko = Korean, nl = Dutch, pt = Portuguese, ru = Russian
Available options:
any, de, es, fr, it, ja, ko, nl, pt, ru Subtitle format. Options: vtt = WEBVTT, xml = XML, plaintext = Plain text
Available options:
vtt, xml, plaintext Response
Run completed.
Session identifier for this run.
Data source identifier for this endpoint.
True when the scrape stopped early and returned the records collected so far.
Markdown summary of the result, for display.
Structured result payload.
Show child attributes
Show child attributes
Points charged for this run.