# Youtube (Videos) # # @website https://www.youtube.com/ # @provide-api yes (https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list) # # @using-api yes # @results JSON # @stable yes # @parse url, title, content, publishedDate, thumbnail, embedded from json import loads from urllib import urlencode from dateutil import parser # engine dependent config categories = ['videos', 'music'] paging = False language_support = True api_key = None # search-url base_url = 'https://www.googleapis.com/youtube/v3/search' search_url = base_url + '?part=snippet&{query}&maxResults=20&key={api_key}' embedded_url = '<iframe width="540" height="304" ' +\ 'data-src="//www.youtube-nocookie.com/embed/{videoid}" ' +\ 'frameborder="0" allowfullscreen></iframe>' base_youtube_url = 'https://www.youtube.com/watch?v=' # do search-request def request(query, params): params['url'] = search_url.format(query=urlencode({'q': query}), api_key=api_key) # add language tag if specified if params['language'] != 'all': params['url'] += '&relevanceLanguage=' + params['language'].split('_')[0] return params # get response from search-request def response(resp): results = [] search_results = loads(resp.text) # return empty array if there are no results if 'items' not in search_results: return [] # parse results for result in search_results['items']: videoid = result['id']['videoId'] title = result['snippet']['title'] content = '' thumbnail = '' pubdate = result['snippet']['publishedAt'] publishedDate = parser.parse(pubdate) thumbnail = result['snippet']['thumbnails']['high']['url'] content = result['snippet']['description'] url = base_youtube_url + videoid embedded = embedded_url.format(videoid=videoid) # append result results.append({'url': url, 'title': title, 'content': content, 'template': 'videos.html', 'publishedDate': publishedDate, 'embedded': embedded, 'thumbnail': thumbnail}) # return results return results