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. To scrape Google Videos results with SerpApi, create a search with these parameters:

API Parameters

tbm

Required

Parameter must be set to vid. (I.e., tbm=vid)

API Examples

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",
      "snippet": "String - Description of video",
      "duration": "String - Lenght of video",
      "rich_snippet": "Hash - Rich data of video",
    },
  ],
  "found_in_videos": [
    {
      "thumbnail": "String - Displayed thumbnail of video",
      "key_moment": {
        "time": "String - Start time of the moment in the video",
        "title": "String - Title of the moment in the video"
      },
      "title": "String - Title of video",
      "link": "String - Link to video",
      "channel": "String - Youtube channel name",
    },
  ]
  ...
}

Results for: `Coffee`

JSON Example

{
  "video_results": [
    {
      "position": 1,
      "title": "Coffee | The Nutrition Source",
      "link": "https://www.hsph.harvard.edu/nutritionsource/food-features/coffee/",
      "displayed_link": "www.hsph.harvard.edu › ... › Food Features",
      "thumbnail": "<URL to image>",
      "snippet": "Coffee beans are the seeds of a fruit called a coffee cherry. Coffee cherries grow on coffee trees from a ...",
      "duration": "0:58",
      "rich_snippet": {
        "top": {
          "extensions": [
            "Harvard T.H. Chan School of Public Health",
            "Harvard T.H. Chan School of Public Health",
            "Feb 27, 2019"
          ],
          "detected_extensions": {
            "feb": 27
          }
        }
      }
    },
    {
      "position": 2,
      "title": "Miguel - Coffee (Official Video) - YouTube",
      "link": "https://www.youtube.com/watch?v=9Z55sZ2oVY4",
      "displayed_link": "www.youtube.com › watch",
      "thumbnail": "<URL to image>",
      "snippet": "'Coffee' by Miguel Listen to Miguel: https://Miguel.lnk.to/listenYDSubscribe to the official Miguel YouTube ...",
      "duration": "4:55",
      "rich_snippet": {
        "top": {
          "extensions": [
            "YouTube",
            "MiguelVEVO",
            "Jun 16, 2015"
          ],
          "detected_extensions": {
            "jun": 16
          }
        }
      }
    },
    ...
  ]
}

Results for: `Coffee` on mobile devices

For some searches, Google videos search includes "Found in videos". SerpApi is able to scrape, extract, and make sense of this information.