Google Video Results API
When SerpApi encounters video results, we add them to our JSON output as the array video_results
. For each video result, we are able to extract its title
, link
, displayed_link
, thumbnail
, snippet
, rich_snippet
.
API Examples
Results for: Coffee
{
"video_results": [
{
"position": 1,
"title": "How I ACTUALLY Make Coffee At Home",
"link": "https://www.youtube.com/watch?v=oiHdMqQ9UV0",
"displayed_link": "www.youtube.com › watch",
"thumbnail": "https://serpapi.com/searches/66e18e2da54d7530b45f5989/images/3b081b8bc8929675a4269d4807644790d01515072958a1595d231ecdfc4aecaa.jpeg",
"date": "1 month ago",
"snippet": "Check out the Fits Everybody Collection at http://www.skims.com/mdc #skimspartner —- 00:00 Hello There 00:52 Pourover Setup 06:32 Pourover ...",
"key_moments": [
{
"time": "00:00",
"title": "Hello There",
"link": "https://www.youtube.com/watch?v=oiHdMqQ9UV0&t=0",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR9bVZD5eUX5DC817yi4pfx2hr5cy1_7beQcB1qdEpgLw&s"
},
{
"time": "00:52",
"title": "Pourover Setup",
"link": "https://www.youtube.com/watch?v=oiHdMqQ9UV0&t=52",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSEp4K_KePnURON6XiHZC_1c5SEjhI6v7H6edXgI_jHhA&s"
},
{
"time": "06:32",
"title": "Pourover Recipe",
"link": "https://www.youtube.com/watch?v=oiHdMqQ9UV0&t=392",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRt0QVVcMHnqsA9_5Br5hxfk2fjCZULltwodaz13U2VLg&s"
},
{
"time": "09:37",
"title": "Espresso Station",
"link": "https://www.youtube.com/watch?v=oiHdMqQ9UV0&t=577",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTSF3RmpxBApolB4gI4S4IpwReqVzsxbDNCChiA4n72Jw&s"
}
],
"rich_snippet": {
"top": {
"extensions": [
"YouTube",
"Morgan Eckroth",
"1 month ago"
],
"detected_extensions": {
"month_ago": 1
}
}
},
"duration": "18:39",
"video_link": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcRZGghMvKDsUh6BVdNwfgBHVpTGAXZeWETYlw"
},
{
"position": 2,
"title": "Are you buying the right Coffee Beans? (Beginner's Guide to ...",
"link": "https://www.youtube.com/watch?v=uWWVNq5GHp4",
"displayed_link": "www.youtube.com › watch",
"thumbnail": "https://serpapi.com/searches/66e18e2da54d7530b45f5989/images/3b081b8bc89296756d749e3cd2d2f07560b848f871a97a4e72cf0bcb9861a044.jpeg",
"date": "May 25, 2024",
"snippet": "Head to https://www.aeropress.com/ethan and save 20% off your order! A huge thank you to AeroPress for sponsoring this video. Coffee beans ...",
"key_moments": [
{
"time": "00:00",
"title": "Intro",
"link": "https://www.youtube.com/watch?v=uWWVNq5GHp4&t=0",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQhQC6e5iS8a19yKmxmc6HmlKwyN9H1dRc8pdFeURqV4A&s"
},
{
"time": "03:18",
"title": "Thank you to AeroPress!",
"link": "https://www.youtube.com/watch?v=uWWVNq5GHp4&t=198",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ6q_yBF4s4oaugJyDiacFIxweq_q1y2LWlgEaK4SRBHA&s"
},
{
"time": "04:45",
"title": "Coffee Roasting Takeaways",
"link": "https://www.youtube.com/watch?v=uWWVNq5GHp4&t=285",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSyaJ5pmV3N3LjMkAP-ZPY4LCDmsGdEm7tCFdumFv5fmw&s"
},
...
],
"rich_snippet": {
"top": {
"extensions": [
"YouTube",
"Ethan Chlebowski",
"May 25, 2024"
],
"detected_extensions": {
"may": 25
}
}
},
"duration": "49:14",
"video_link": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcQ1dJvv24fGuse2ciIDrlk8sOvQZRfz2AaT8w"
},
{
"position": 3,
"title": "A Day With a Barista in One of NYC's Busiest Coffee Shops ...",
"link": "https://www.youtube.com/watch?v=aJwdWeiSc8c",
"displayed_link": "www.youtube.com › watch",
"thumbnail": "https://serpapi.com/searches/66e18e2da54d7530b45f5989/images/3b081b8bc8929675120f5fce60d6b3966a0fee26384d806f3e219a4bf6968e62.jpeg",
"date": "3 weeks ago",
"snippet": "Americanos and iced lattes and cold brews, oh my! In this episode of \"On The Job,\" Priya Krishna dives into the daily grind of baristas.",
"rich_snippet": {
"top": {
"extensions": [
"YouTube",
"NYT Cooking",
"3 weeks ago"
],
"detected_extensions": {
"weeks_ago": 3
}
}
},
"duration": "13:17",
"video_link": "https://encrypted-vtbn0.gstatic.com/video?q=tbn:ANd9GcTTjCgSqJW6bfd00t-oOE3JmnLSfe7h3pw0mg"
},
...
]
}
JSON structure overview
{
"video_results": [
{
"position": "Number - Position of video"
"title": "String - Title of video",
"link": "String - Link to video",
"displayed_link": "String - Displayed link of video",
"thumbnail": "String - Displayed thumbnail of video",
"date": "String - Date of video",
"snippet": "String - Description of video",
"key_moments": [
{
"time": "String - Start time of the moment in the video",
"title": "String - Title of the moment in the video",
"link": "String - Link to the moment in the video",
"thumbnail": "String - Thumbnail of the moment in the video"
}
],
"duration": "String - Lenght of video",
"rich_snippet": "Hash - Rich data of video",
"video_link": "String - Link to the small video shown in the results"
}
]
}