Get Data
YouTube Search Results
Get Data
- POSTWeb Page Content
- POSTWeb Page Screenshot
- POSTYouTube Video Transcript
- POSTYouTube Channel Data
- POSTGet Twitter Users
- POSTGet Company Earnings Info
- POSTGet Company Financial Profile
- POSTGet Domain Information
- POSTGoogle News Data
- POSTYouTube Search Results
- POSTSearch Results
- POSTGet Recent Tweets
- POSTGet LinkedIn Profile
- POSTGet LinkedIn Activity
- POSTEnrich Company Data
- POSTGet Bluesky Posts
- POSTSearch Bluesky Posts
- POSTGet Instagram Profile
- POSTGet Instagram Followers
Get Data
YouTube Search Results
Perform a YouTube search and retrieve results for specified queries.
POST
/
action
/
run_youtube_search
curl --request POST \
--url https://api-lr.agent.ai/v1/action/run_youtube_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"query": "machine learning tutorials"
}'
{
"status": 200,
"response": {
"search_information": {
"total_results": 3383350
},
"search_parameters": {
"engine": "youtube",
"gl": "US",
"hl": "en",
"q": "AI advancements"
},
"shorts": [
{
"items": [
{
"id": "OI1vPRfnN2o",
"link": "https://www.youtube.com/shorts/OI1vPRfnN2o",
"position": 1,
"thumbnail": "https://i.ytimg.com/vi/OI1vPRfnN2o/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLBcsaGmJ8EwCfjCpatPL462tFR1UQ",
"title": "The world is changing — HUGE AI advancements in robotics just happened 🤯 #autonomousrobotics",
"views": 8700
},
{
"id": "OK0YhF3NMpQ",
"link": "https://www.youtube.com/shorts/OK0YhF3NMpQ",
"position": 2,
"thumbnail": "https://i.ytimg.com/vi/OK0YhF3NMpQ/hq720.jpg?sqp=-oaymwEdCJUDENAFSFXyq4qpAw8IARUAAIhCcAHAAQbQAQE=&rs=AOn4CLCHSrIC86zUTlRystaI2t8wQzYveA",
"title": "OpenAI's CEO on What Kids Should Be Studying",
"views": 4200000
},
{
"id": "hB0pqmq9IKg",
"link": "https://www.youtube.com/shorts/hB0pqmq9IKg",
"position": 3,
"thumbnail": "https://i.ytimg.com/vi/hB0pqmq9IKg/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDfwABwpUhMCmgy00FviHPciFNmBQ",
"title": "Using AI, they can automatically identify and categorize what their satellites see.",
"views": 2800000
}
],
"position": 9,
"section_title": "Shorts"
},
{
"items": [
{
"id": "DqH_4uJ2BOI",
"link": "https://www.youtube.com/shorts/DqH_4uJ2BOI",
"position": 1,
"thumbnail": "https://i.ytimg.com/vi/DqH_4uJ2BOI/hq720_2.jpg?sqp=-oaymwEdCJYDENAFSFXyq4qpAw8IARUAAIhCcAHAAQbQAQE=&rs=AOn4CLBo5_OSidSf_dIUG-HAlHkGk4hLDg",
"title": "Elon Musk's Prediction for AI Future",
"views": 571000
},
{
"id": "wQCRZlbLgY4",
"link": "https://www.youtube.com/shorts/wQCRZlbLgY4",
"position": 2,
"thumbnail": "https://i.ytimg.com/vi/wQCRZlbLgY4/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDG1izH6eaT9peuefHHxb10oE5y2w",
"title": "The future of AI",
"views": 2300000
},
{
"id": "ItvWg1duv_k",
"link": "https://www.youtube.com/shorts/ItvWg1duv_k",
"position": 3,
"thumbnail": "https://i.ytimg.com/vi/ItvWg1duv_k/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCqNnmpYosU6J_Q5SNgbm9RMS8ncg",
"title": "Why AI Is More Important Than We Thought",
"views": 5200
}
],
"position": 13,
"section_title": "Shorts"
}
],
"suggestions": [
"ai tutorial",
"ai news",
"ai future",
"artificial intelligence news",
"artificial intelligence robot",
"artificial intelligence documentary",
"how does ai work",
"what is ai",
"artificial intelligence podcast",
"ai advantage",
"mustafa suleyman",
"ai learning",
"two minute papers",
"artificial intelligence explained",
"what is artificial intelligence"
],
"videos": [
{
"badges": [
"New"
],
"channel": {
"id": "UC5l7RouTQ60oUjLjt1Nh-UQ",
"is_verified": true,
"link": "https://www.youtube.com/@airevolutionx",
"thumbnail": "https://yt3.ggpht.com/XRZC_XqZoSUtB_Zo9R0w2vDRqGqVv0lKZTRYI6b-7DPKi32MtByVhxgIokLAguhf7fw__K8o3g=s68-c-k-c0x00ffffff-no-rj",
"title": "AI Revolution"
},
"description": "AI-powered humanoid robots are rapidly advancing, with the Phantom MK1 making its first public appearance in a nightclub ...",
"id": "yrGKgdxnsHA",
"length": "9:48",
"link": "https://www.youtube.com/watch?v=yrGKgdxnsHA",
"position": 1,
"published_time": "2 days ago",
"thumbnail": {
"rich": "https://i.ytimg.com/vi/yrGKgdxnsHA/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLALbhxknt2JnWP6RkVAPkmhcsaMgg",
"static": "https://i.ytimg.com/vi/yrGKgdxnsHA/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCWOsAcglqmbAjzlT2L0rzUmJ6w8Q"
},
"title": "The First AI Humanoid Soldier SHOCKED The Internet!",
"views": 35861
}
]
}
}
Authorizations
Bearer token from your account (https://agent.ai/user/settings#credits)
Body
application/json
Search terms for YouTube.
curl --request POST \
--url https://api-lr.agent.ai/v1/action/run_youtube_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"query": "machine learning tutorials"
}'
{
"status": 200,
"response": {
"search_information": {
"total_results": 3383350
},
"search_parameters": {
"engine": "youtube",
"gl": "US",
"hl": "en",
"q": "AI advancements"
},
"shorts": [
{
"items": [
{
"id": "OI1vPRfnN2o",
"link": "https://www.youtube.com/shorts/OI1vPRfnN2o",
"position": 1,
"thumbnail": "https://i.ytimg.com/vi/OI1vPRfnN2o/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLBcsaGmJ8EwCfjCpatPL462tFR1UQ",
"title": "The world is changing — HUGE AI advancements in robotics just happened 🤯 #autonomousrobotics",
"views": 8700
},
{
"id": "OK0YhF3NMpQ",
"link": "https://www.youtube.com/shorts/OK0YhF3NMpQ",
"position": 2,
"thumbnail": "https://i.ytimg.com/vi/OK0YhF3NMpQ/hq720.jpg?sqp=-oaymwEdCJUDENAFSFXyq4qpAw8IARUAAIhCcAHAAQbQAQE=&rs=AOn4CLCHSrIC86zUTlRystaI2t8wQzYveA",
"title": "OpenAI's CEO on What Kids Should Be Studying",
"views": 4200000
},
{
"id": "hB0pqmq9IKg",
"link": "https://www.youtube.com/shorts/hB0pqmq9IKg",
"position": 3,
"thumbnail": "https://i.ytimg.com/vi/hB0pqmq9IKg/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDfwABwpUhMCmgy00FviHPciFNmBQ",
"title": "Using AI, they can automatically identify and categorize what their satellites see.",
"views": 2800000
}
],
"position": 9,
"section_title": "Shorts"
},
{
"items": [
{
"id": "DqH_4uJ2BOI",
"link": "https://www.youtube.com/shorts/DqH_4uJ2BOI",
"position": 1,
"thumbnail": "https://i.ytimg.com/vi/DqH_4uJ2BOI/hq720_2.jpg?sqp=-oaymwEdCJYDENAFSFXyq4qpAw8IARUAAIhCcAHAAQbQAQE=&rs=AOn4CLBo5_OSidSf_dIUG-HAlHkGk4hLDg",
"title": "Elon Musk's Prediction for AI Future",
"views": 571000
},
{
"id": "wQCRZlbLgY4",
"link": "https://www.youtube.com/shorts/wQCRZlbLgY4",
"position": 2,
"thumbnail": "https://i.ytimg.com/vi/wQCRZlbLgY4/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDG1izH6eaT9peuefHHxb10oE5y2w",
"title": "The future of AI",
"views": 2300000
},
{
"id": "ItvWg1duv_k",
"link": "https://www.youtube.com/shorts/ItvWg1duv_k",
"position": 3,
"thumbnail": "https://i.ytimg.com/vi/ItvWg1duv_k/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCqNnmpYosU6J_Q5SNgbm9RMS8ncg",
"title": "Why AI Is More Important Than We Thought",
"views": 5200
}
],
"position": 13,
"section_title": "Shorts"
}
],
"suggestions": [
"ai tutorial",
"ai news",
"ai future",
"artificial intelligence news",
"artificial intelligence robot",
"artificial intelligence documentary",
"how does ai work",
"what is ai",
"artificial intelligence podcast",
"ai advantage",
"mustafa suleyman",
"ai learning",
"two minute papers",
"artificial intelligence explained",
"what is artificial intelligence"
],
"videos": [
{
"badges": [
"New"
],
"channel": {
"id": "UC5l7RouTQ60oUjLjt1Nh-UQ",
"is_verified": true,
"link": "https://www.youtube.com/@airevolutionx",
"thumbnail": "https://yt3.ggpht.com/XRZC_XqZoSUtB_Zo9R0w2vDRqGqVv0lKZTRYI6b-7DPKi32MtByVhxgIokLAguhf7fw__K8o3g=s68-c-k-c0x00ffffff-no-rj",
"title": "AI Revolution"
},
"description": "AI-powered humanoid robots are rapidly advancing, with the Phantom MK1 making its first public appearance in a nightclub ...",
"id": "yrGKgdxnsHA",
"length": "9:48",
"link": "https://www.youtube.com/watch?v=yrGKgdxnsHA",
"position": 1,
"published_time": "2 days ago",
"thumbnail": {
"rich": "https://i.ytimg.com/vi/yrGKgdxnsHA/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLALbhxknt2JnWP6RkVAPkmhcsaMgg",
"static": "https://i.ytimg.com/vi/yrGKgdxnsHA/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCWOsAcglqmbAjzlT2L0rzUmJ6w8Q"
},
"title": "The First AI Humanoid Soldier SHOCKED The Internet!",
"views": 35861
}
]
}
}