Prerequisite:
Youtube Data API | Set-1
In the
previous article we have discussed first two variants of search method. Now let's discuss the remaining three- Search Live Events, Search Related Videos and Search My Videos.
Search by Live Events:
Given example retrieves top 5 live broadcasts associated with the query string Python Programming.
type parameter
must be set to the value video only.
eventType
parameter can take any value from given set of values- completed (this will include only completed broadcasts), live (this will include only active broadcasts), upcoming (this will include only upcoming broadcasts).
Python3 1==
from apiclient.discovery import build
# Arguments that need to passed to the build function
DEVELOPER_KEY = "Your_API_Key"
YOUTUBE_API_SERVICE_NAME = "youtube"
YOUTUBE_API_VERSION = "v3"
# creating Youtube Resource Object
youtube_object = build(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION,
developerKey = DEVELOPER_KEY)
def youtube_search_location(query, max_results = 2):
# calling the search.list method to
# retrieve youtube search results
search_location = youtube_object.search().list(q = query,
type ='video', eventType ='live',
part = "id, snippet",
maxResults = max_results).execute()
# extracting the results from search response
results = search_location.get("items", [])
# empty list to store video metadata
videos = []
# extracting required info
# from each result object
for result in results:
# video result object
if result['id']['kind'] == "youtube# video":
videos.append("% s (% s) (% s) (% s)" % (result["snippet"]["title"],
result["id"]["videoId"], result['snippet']['description'],
result['snippet']['thumbnails']['default']['url']))
print ("Videos:\n", "\n".join(videos), "\n")
if __name__ == "__main__":
youtube_search_location('Social Media', max_results = 2)
Output:
Search by Related To video: This will help to retrieve videos related to the video specified by the Video Id in the parameter list.
type parameter
can only take value video.
Python3 1==
from apiclient.discovery import build
# Arguments that need to passed
# to the build function
DEVELOPER_KEY = "Your_API_Key"
YOUTUBE_API_SERVICE_NAME = "youtube"
YOUTUBE_API_VERSION = "v3"
# creating Youtube Resource Object
youtube_object = build(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION,
developerKey = DEVELOPER_KEY)
def youtube_search_relatedto(max_results = 2):
# calling the search.list method to
# retrieve youtube search results
search_relatedto = youtube_object.search().list(type ='video',
relatedToVideoId ='X06Vml-8X8A',
part = "id, snippet",
maxResults = max_results).execute()
# extracting the results from search response
results = search_relatedto.get("items", [])
# empty list to store video metadata
videos = []
# extracting required info from each result object
for result in results:
# video result object
if result['id']['kind'] == "youtube# video":
videos.append("% s (% s) (% s) (% s)" % (result["snippet"]["title"],
result["id"]["videoId"],
result['snippet']['description'],
result['snippet']['thumbnails']['default']['url']))
print ("Videos:\n", "\n".join(videos), "\n")
if __name__ == "__main__":
youtube_search_relatedto(max_results = 2)
Output:
Search My Videos: This example search for the videos matching with keyword "Geeksforgeeks" in authorized user's account.
forMine
parameter indicates that the search should be done within the authorized user's account.
type
parameter must also be set to video. Since this method requires user's authentication so we will be creating
OAuth
type of credential for this example. Follow the steps below to generate a Client Id and a Secret Key.
- Go to Google Google Developers Console and Click on Sign In in the upper rightmost corner of the page. Sign In using the credentials of the valid Google Account. If you don’t have a google account, setup a account first and then use the details to Sign In on the Google Developers Homepage.
- Now navigate to the Developer Dashboard and create a new Project.
- Click on Enable API option.
- In the search field, search for Youtube Data API and select the Youtube Data API option that comes in the drop down list.
- You will be redirected to a screen that says information about the Youtube Data API, along with two options : ENABLE and TRY API.
- Click on ENABLE option to get started with the API.
- In the sidebar under APIs & Services, select Credentials.
- At the top of the page, select the OAuth consent screen tab. Select an Email address, enter a Product name if not already set, and click the Save button.
- In the Credentials tab, select the Create credentials drop-down list, and choose OAuth Client Id. OAuth is generally used where authorization is required like in the case of retrieving liked videos of a user.
- Select the application type Other, enter the name "YouTube Data API Myvideos", and click the Create button.
- Click OK.
- Click on Download button to the right of the client Id to download the JSON file.
- Save and rename the file as client_secret.json and move it to the working directory.
Install additional libraries using the
pip command:
pip install --upgrade google-auth google-auth-oauthlib google-auth-httplib2
Python3 1==
# importing libraries
import os
import google.oauth2.credentials
import google_auth_oauthlib.flow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError
from google_auth_oauthlib.flow import InstalledAppFlow
# The CLIENT_SECRETS_FILE variable specifies
# the name of a file that contains
# client_id and client_secret.
CLIENT_SECRETS_FILE = "client_secret.json"
# This scope allows for full read/write
# access to the authenticated user's account
# and requires requests to use an SSL connection.
SCOPES = ['https://www.googleapis.com / auth / youtube.force-ssl']
API_SERVICE_NAME = 'youtube'
API_VERSION = 'v3'
def get_authenticated_service():
flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRETS_FILE, SCOPES)
credentials = flow.run_console()
return build(API_SERVICE_NAME, API_VERSION, credentials = credentials)
def print_response(response):
print(response)
# Build a resource based on a list of
# properties given as key-value pairs.
# Leave properties with empty values out
# of the inserted resource.
def build_resource(properties):
resource = {}
for p in properties:
# Given a key like "snippet.title", split
# into "snippet" and "title", where
# "snippet" will be an object and "title"
# will be a property in that object.
prop_array = p.split('.')
ref = resource
for pa in range(0, len(prop_array)):
is_array = False
key = prop_array[pa]
# For properties that have array values, convert a
# name like "snippet.tags[]" to snippet.tags, and set
# a flag to handle the value as an array.
if key[-2:] == '[]':
key = key[0:len(key)-2:]
is_array = True
if pa == (len(prop_array) - 1):
# Leave properties without values
# out of inserted resource.
if properties[p]:
if is_array:
ref[key] = properties[p].split(', ')
else:
ref[key] = properties[p]
elif key not in ref:
ref[key] = {}
ref = ref[key]
else:
ref = ref[key]
return resource
# Remove keyword arguments that are not set
def remove_empty_kwargs(**kwargs):
good_kwargs = {}
if kwargs is not None:
for key, value in kwargs.items():
if value:
good_kwargs[key] = value
return good_kwargs
def search_list_forMine(client, **kwargs):
kwargs = remove_empty_kwargs(**kwargs)
response = client.search().list(**kwargs).execute()
return print_response(response)
if __name__ == '__main__':
# When running locally, disable OAuthlib's
# HTTPs verification. When running in production
# * do not * leave this option enabled.
os.environ['OAUTHLIB_INSECURE_TRANSPORT'] = '1'
client = get_authenticated_service()
search_list_forMine(client,
part ='snippet',
maxResults = 5,
forMine = True,
q ='Geeksforgeeks',
type ='video')
Output:
While executing the code, it will ask for the authorization code. For getting the code you need to follow the link mentioned in the command prompt screen above the line: Enter the Authorization code.

Now follow the link and copy paste the authorization code that you will get by granting the permission.

Since we don't have any uploaded videos in this account, so the total results value is 0. Output screen looks like this:

Please refer to the
Youtube Data API Documentation(search.list()) for the complete list of parameters that are possible.
References:
- https://developers.google.com/youtube/v3/docs/
- https://developers.google.com/youtube/v3/docs/search/list
Similar Reads
Youtube Data API | Set-1
Google provides a large set of API's for the developer to choose from. Each and every service provided by Google has an associated API. Being one of them, Youtube Data API is very simple to use provides features like - Search for videosHandle videos like retrieve information about a video, insert a
5 min read
Youtube Data API Playlist | Set-2
We already have discussed first two methods for a Playlist - to list all Playlist associated with a Channel Id, To retrieve my Playlist i.e. playlist of authorized user's account. Now, we will be discussing three more methods: Insert a Playlist, Update a Playlist and Delete a Playlist. This means we
11 min read
Youtube Data API Playlist | Set-4
In the last article, we discussed how to list the contents of the desired playlist and how to insert a video in a playlist. Now, in this article, we will be discussing how to update a video in the desired playlist and how to delete the video. So starting with the Updating a video, Let's quickly disc
8 min read
Youtube Data API Playlist | Set-3
From the previous article, we have seen that API can be used to insert, update or delete a playlist. Now the question comes that once we have created a playlist, do we have to go to Youtube and manually add the video to the newly created playlist. NO!!! all you have to do is use the OAuth Credential
8 min read
Youtube Data API Playlist | Set-1
After covering all types of search and video methods, we will be discussing in this article about Playlist. Everyone must be knowing what playlist is in Youtube. There are two ways to retrieve the playlist using Youtube Data API:Â Retrieve all PlaylistRetrieve My Playlist We will discuss these metho
8 min read
Youtube Data API Subscription | Set-2
Prerequisite: Youtube Data API Subscription | Set-1 Now we will be discussing remaining two methods to list subscriptions i.e. to list subscriptions for authorized user's account and to check whether a subscription exists or not. Code to list subscriptions for authorized user's account: This example
6 min read
Youtube Data API Subscription | Set-1
In this article, we will be discussing about the Youtube Subscriptions. How API can be used to retrieve and manipulate these subscriptions. There are three operations that we will be discussing: List all the subscriptions associated with a Youtube channel Insert a new subscription Delete a subscript
5 min read
Youtube Data API Subscription | Set-3
In the previous articles Youtube Data API Subscription | Set 1, Set 2 we have discussed three methods- To retrieve the list of subscriptions associated with a channel Id To retrieve my subscriptions i.e. associated with authorized user's account To check whether a subscription exist or not. In this
8 min read
Youtube Data API for handling videos | Set-2
Prerequisite: Youtube Data API for handling videos | Set-1 We have recently discussed first two variants of video list method, Video List by Video Id and Video List by Multiple Video Ids. Now, let's discuss the other two variants - Video List Most Popular Videos Video List My Liked Videos List most
6 min read
Youtube Data API for handling videos | Set-4
Prerequisite: Youtube Data API for handling videos | Set-1, Set-2, Set-3 In this article we will discuss two methods related to video: Update a Video, Delete a Video. Updating a video and deleting an uploaded video requires user's authorization, so we will be creating OAuth type of credential for th
7 min read