WebSVN – yt_downloader – Diff – /trunk/youtube_functions.inc.phps


<?php
 
// ViaThinkSoft YouTube Downloader Functions 2.3
// Revision: 2022-12-19
// Author: Daniel Marschall <www.daniel-marschall.de>
// Licensed under the terms of the Apache 2.0 License
 
// Get API key:   https://console.developers.google.com/apis/credentials
// Test API here: https://developers.google.com/apis-explorer/?hl=de#p/youtube/v3/youtube.playlistItems.list
 
$yt_apikey = null;
$yt_apikey_callback = null;
 
function yt_set_apikey($apikey) {
        global $yt_apikey;
        $yt_apikey = $apikey;
}
 
function yt_set_apikey_callback($apikey_callback) {
        global $yt_apikey_callback;
        $yt_apikey_callback = $apikey_callback;
}
 
function yt_get_apikey() {
        global $yt_apikey, $yt_apikey_callback;
 
        if (!empty($yt_apikey_callback)) {
                $apikey = call_user_func($yt_apikey_callback);
                if (!yt_check_apikey_syntax($apikey)) throw new Exception("Invalid API key '$apikey'");
        } else if (!empty($yt_apikey)) {
                $apikey = $yt_apikey;
                if (!yt_check_apikey_syntax($apikey)) throw new Exception("Invalid API key '$apikey'");
        } else {
                throw new Exception("This function requires a YouTube API key.\n");
        }
 
        return $apikey;
}
 
function yt_playlist_items($playlist_id, $maxresults=-1) {
        $out = array();
 
        $next_page_token = '';
 
        do {
                $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/playlistItems?part=snippet&playlistId='.urlencode($playlist_id).'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));
                if (!$cont) return false; // e.g. if Playlist was deleted
 
                $obj = json_decode($cont, true);
                if (!$obj) return false;
 
                if (!isset($obj['items'])) return false;
 
                foreach ($obj['items'] as $item) {
                        if ($item['snippet']['resourceId']['kind'] == 'youtube#video') {
                                $title    = $item['snippet']['title'];
                                $video_id = $item['snippet']['resourceId']['videoId'];
                                $out[] = array($video_id, $title);
                                if (($maxresults != -1) && ($maxresults == count($out))) return $out;
                        }
                }
 
                $next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';
        } while ($next_page_token != '');
 
        return $out;
}
 
function yt_get_channel_id($username) {
        $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&forUsername='.urlencode($username).'&part=id');
        if (!$cont) return false;
 
        $obj = json_decode($cont, true);
        if (!$obj) return false;
 
        if (!isset($obj['items'])) return false;
 
        foreach ($obj['items'] as $item) {
                if ($item['kind'] == 'youtube#channel') {
                        return $item['id'];
                }
        }
}
 
function yt_get_channel_id_and_stats($username) {
        $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&forUsername='.urlencode($username).'&part=id,statistics');
        if (!$cont) return false;
 
        $obj = json_decode($cont, true);
        if (!$obj) return false;
 
        if (!isset($obj['items'])) return false;
 
        foreach ($obj['items'] as $item) {
                if ($item['kind'] == 'youtube#channel') {
                        return array($item['id'], $item['statistics']);
                }
        }
}
 
function yt_get_channel_stats($channel_id) {
        $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&id='.urlencode($channel_id).'&part=statistics');
        if (!$cont) return false;
 
        $obj = json_decode($cont, true);
        if (!$obj) return false;
 
        if (!isset($obj['items'])) return false; //totalResults could be 0
 
        foreach ($obj['items'] as $item) {
                if ($item['kind'] == 'youtube#channel') {
                        return $item['statistics'];
                }
        }
}
 
function yt_get_playlist_stats($playlist_id) {
        $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/playlists?part=contentDetails&id='.urlencode($playlist_id).'&key='.urlencode(yt_get_apikey()));
        if (!$cont) return false;
 
        $obj = json_decode($cont, true);
        if (!$obj) return false;
 
        if (!isset($obj['items'])) return false;
 
        foreach ($obj['items'] as $item) {
                if ($item['kind'] == 'youtube#playlist') {
                        if (!isset($item['contentDetails']) || is_null($item['contentDetails'])) return false; // can happen to deleted playlists
                        return $item['contentDetails'];
                }
        }
}
 
function yt_channel_items($channel_id, $searchterms='', $maxresults=-1) {
        $out = array();
 
        $next_page_token = '';
 
        do {
                $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/search?part=snippet&channelId='.urlencode($channel_id).(($searchterms!='') ? '&q='.urlencode($searchterms) : '').'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));
                if (!$cont) return false;
 
                $obj = json_decode($cont, true);
                if (!$obj) return false;
 
                if (!isset($obj['items'])) return false;
 
                foreach ($obj['items'] as $item) {
                        if ($item['id']['kind'] == 'youtube#video') {
                                $title    = $item['snippet']['title'];
                                $video_id = $item['id']['videoId'];
                                $out[] = array($video_id, $title);
                                if (($maxresults != -1) && ($maxresults == count($out))) return $out;
                        }
                }
 
                $next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';
        } while ($next_page_token != '');
 
        return $out;
}
 
// Acceptable order values are: date, rating, relevance(default), title, videoCount, viewCount
function yt_search_items($searchterms, $order='', $maxresults=-1) {
        $out = array();
 
        $next_page_token = '';
 
        do {
                $cont = @file_get_contents('https://www.googleapis.com/youtube/v3/search?part=snippet&q='.urlencode($searchterms).(($order!='') ? '&order='.urlencode($order) : '').'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));
                if (!$cont) return false;
 
                $obj = json_decode($cont, true);
                if (!$obj) return false;
 
                if (!isset($obj['items'])) return false;
 
                foreach ($obj['items'] as $item) {
                        if ($item['id']['kind'] == 'youtube#video') {
                                $title    = $item['snippet']['title'];
                                $video_id = $item['id']['videoId'];
                                $out[] = array($video_id, $title);
                                if (($maxresults != -1) && ($maxresults == count($out))) return $out;
                        }
                }
 
                $next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';
        } while ($next_page_token != '');
 
        return $out;
}
 
function getVideoIDFromURL($url) {
        // Extract video ID from the URL
 
        $vid = false;
        $m = null;
 
        # Usual format
        if (($vid === false) && (preg_match("@https{0,1}://(www\\.|)youtube\\.com/watch(.*)(/|&|\\?)v=([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {
                $vid = $m[4];
        }
 
        # Short format
        if (($vid === false) && (preg_match("@https{0,1}://(www\\.|)youtu\\.be/([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {
                $vid = $m[2];
        }
 
        # YouTube "Shorts"
        if (($vid === false) && (preg_match("@https{0,1}://(www\\.|)youtube\\.com/shorts/([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {
                $vid = $m[2];
        }
 
        return $vid;
}
 
function getPlaylistIDFromURL($url) {
        $pid = false;
 
        # Usual format
        $m = null;
        if (($pid === false) && (preg_match("@https{0,1}://(www\\.|)youtube\\.com/(.*)(/|&|\\?)list=(.+)&@ismU", $url.'&', $m))) {
                $pid = $m[4];
        }
 
        return $pid;
}
 
function yt_check_apikey_syntax($apikey) {
        return preg_match('@^[a-zA-Z0-9]{39}$@', $apikey);
}
 
function yt_check_video_id($video_id) {
        return preg_match('@^[a-zA-Z0-9\-_]{11}$@', $video_id);
}
 
function yt_get_channel_id_from_custom_url($custom_url) {
        // TODO: is there any API possibility??? API only accepts username and id ?!
 
        // https://www.youtube.com/c/SASASMR
        // <link rel="canonical" href="https://www.youtube.com/channel/UCp4LfMtDfoa29kTlLnqQ5Mg">
        // https://www.youtube.com/impaulsive
        // <link rel="canonical" href="https://www.youtube.com/channel/UCGeBogGDZ9W3dsGx-mWQGJA">
        // https://www.youtube.com/@KosmonautMusicSpecials
        // <link rel="canonical" href="https://www.youtube.com/channel/UCayYOQ0DEIpcTgO9z_b-K1A">
 
        $cont = @file_get_contents($custom_url);
        if ($cont === false) {
                throw new Exception("Cannot open $custom_url using file_get_contents.");
        }
        if (!preg_match('@<link rel="canonical" href="https://www.youtube.com/channel/([^"]+)">@ismU', $cont, $m)) {
                return false;
        }
 
        return $m[1];
}
 
function yt_get_channel_id_from_url($channel_url) {
        $m = null;
        if (preg_match("@https{0,1}://(www\\.|)youtube\\.com/user/(.*)(/|&|\\?)@ismU", $channel_url.'&', $m)) {
                // Username (deprecated feature. Not every channel has a username associated with it)
                // https://www.youtube.com/user/USERNAME
                $username = $m[2];
                $channel_id = yt_get_channel_id($username);
                return $channel_id;
        } else if (preg_match("@https{0,1}://(www\\.|)youtube\\.com/channel/(.*)(/|&|\\?)@ismU", $channel_url.'&', $m)) {
                // Real channel ID
                // https://www.youtube.com/channel/ID
                $channel_id = $m[2];
                return $channel_id;
        } else if (preg_match("@https{0,1}://(www\\.|)youtube\\.com/(c/){0,1}(.*)(/|&|\\?)@ismU", $channel_url.'&', $m)) {
                // Channel custom URL
                // https://www.youtube.com/NAME or https://www.youtube.com/c/NAME
                return yt_get_channel_id_from_custom_url($channel_url);
        } else {
                return false;
        }
}
 
// Examples:
//yt_set_apikey(trim(file_get_contents(__DIR__ . '/.yt_api_key')));
//print_r(yt_playlist_items('PL9GbGAd-gY1pyxZJIX5MOdYdRbdweVAID'));
//print_r(yt_channel_items('UCjPjcMEAN64opOoNQE9GykA'));
//print_r(yt_channel_items('UCjPjcMEAN64opOoNQE9GykA', 'Knight'));
//print_r(yt_search_items('Wesley Willis', 'date', 10));
 

Subversion Repositories yt_downloader

yt_downloader/trunk/youtube_functions.inc.phps – Rev 16 → 19

Rev 16		Rev 19
1	<?php	1	<?php
2		2
3	// ViaThinkSoft YouTube Downloader Functions 2.3	3	// ViaThinkSoft YouTube Downloader Functions 2.3
4	// Revision: 2022-02-06	4	// Revision: 2022-12-19
5	// Author: Daniel Marschall <www.daniel-marschall.de>	5	// Author: Daniel Marschall <www.daniel-marschall.de>
6	// Licensed under the terms of the Apache 2.0 License	6	// Licensed under the terms of the Apache 2.0 License
7		7
8	// Get API key: https://console.developers.google.com/apis/credentials	8	// Get API key: https://console.developers.google.com/apis/credentials
9	// Test API here: https://developers.google.com/apis-explorer/?hl=de#p/youtube/v3/youtube.playlistItems.list	9	// Test API here: https://developers.google.com/apis-explorer/?hl=de#p/youtube/v3/youtube.playlistItems.list
10		10
11	$yt_apikey = null;	11	$yt_apikey = null;
12	$yt_apikey_callback = null;	12	$yt_apikey_callback = null;
13		13
14	function yt_set_apikey($apikey) {	14	function yt_set_apikey($apikey) {
15	global $yt_apikey;	15	global $yt_apikey;
16	$yt_apikey = $apikey;	16	$yt_apikey = $apikey;
17	}	17	}
18		18
19	function yt_set_apikey_callback($apikey_callback) {	19	function yt_set_apikey_callback($apikey_callback) {
20	global $yt_apikey_callback;	20	global $yt_apikey_callback;
21	$yt_apikey_callback = $apikey_callback;	21	$yt_apikey_callback = $apikey_callback;
22	}	22	}
23		23
24	function yt_get_apikey() {	24	function yt_get_apikey() {
25	global $yt_apikey, $yt_apikey_callback;	25	global $yt_apikey, $yt_apikey_callback;
26		26
27	if (!empty($yt_apikey_callback)) {	27	if (!empty($yt_apikey_callback)) {
28	$apikey = call_user_func($yt_apikey_callback);	28	$apikey = call_user_func($yt_apikey_callback);
29	if (!yt_check_apikey_syntax($apikey)) throw new Exception("Invalid API key '$apikey'");	29	if (!yt_check_apikey_syntax($apikey)) throw new Exception("Invalid API key '$apikey'");
30	} else if (!empty($yt_apikey)) {	30	} else if (!empty($yt_apikey)) {
31	$apikey = $yt_apikey;	31	$apikey = $yt_apikey;
32	if (!yt_check_apikey_syntax($apikey)) throw new Exception("Invalid API key '$apikey'");	32	if (!yt_check_apikey_syntax($apikey)) throw new Exception("Invalid API key '$apikey'");
33	} else {	33	} else {
34	throw new Exception("This function requires a YouTube API key.\n");	34	throw new Exception("This function requires a YouTube API key.\n");
35	}	35	}
36		36
37	return $apikey;	37	return $apikey;
38	}	38	}
39		39
40	function yt_playlist_items($playlist_id, $maxresults=-1) {	40	function yt_playlist_items($playlist_id, $maxresults=-1) {
41	$out = array();	41	$out = array();
42		42
43	$next_page_token = '';	43	$next_page_token = '';
44		44
45	do {	45	do {
46	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/playlistItems?part=snippet&playlistId='.urlencode($playlist_id).'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));	46	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/playlistItems?part=snippet&playlistId='.urlencode($playlist_id).'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));
47	if (!$cont) return false; // e.g. if Playlist was deleted	47	if (!$cont) return false; // e.g. if Playlist was deleted
48		48
49	$obj = json_decode($cont, true);	49	$obj = json_decode($cont, true);
50	if (!$obj) return false;	50	if (!$obj) return false;
51		51
52	if (!isset($obj['items'])) return false;	52	if (!isset($obj['items'])) return false;
53		53
54	foreach ($obj['items'] as $item) {	54	foreach ($obj['items'] as $item) {
55	if ($item['snippet']['resourceId']['kind'] == 'youtube#video') {	55	if ($item['snippet']['resourceId']['kind'] == 'youtube#video') {
56	$title = $item['snippet']['title'];	56	$title = $item['snippet']['title'];
57	$video_id = $item['snippet']['resourceId']['videoId'];	57	$video_id = $item['snippet']['resourceId']['videoId'];
58	$out[] = array($video_id, $title);	58	$out[] = array($video_id, $title);
59	if (($maxresults != -1) && ($maxresults == count($out))) return $out;	59	if (($maxresults != -1) && ($maxresults == count($out))) return $out;
60	}	60	}
61	}	61	}
62		62
63	$next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';	63	$next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';
64	} while ($next_page_token != '');	64	} while ($next_page_token != '');
65		65
66	return $out;	66	return $out;
67	}	67	}
68		68
69	function yt_get_channel_id($username) {	69	function yt_get_channel_id($username) {
70	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&forUsername='.urlencode($username).'&part=id');	70	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&forUsername='.urlencode($username).'&part=id');
71	if (!$cont) return false;	71	if (!$cont) return false;
72		72
73	$obj = json_decode($cont, true);	73	$obj = json_decode($cont, true);
74	if (!$obj) return false;	74	if (!$obj) return false;
75		75
76	if (!isset($obj['items'])) return false;	76	if (!isset($obj['items'])) return false;
77		77
78	foreach ($obj['items'] as $item) {	78	foreach ($obj['items'] as $item) {
79	if ($item['kind'] == 'youtube#channel') {	79	if ($item['kind'] == 'youtube#channel') {
80	return $item['id'];	80	return $item['id'];
81	}	81	}
82	}	82	}
83	}	83	}
84		84
85	function yt_get_channel_id_and_stats($username) {	85	function yt_get_channel_id_and_stats($username) {
86	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&forUsername='.urlencode($username).'&part=id,statistics');	86	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&forUsername='.urlencode($username).'&part=id,statistics');
87	if (!$cont) return false;	87	if (!$cont) return false;
88		88
89	$obj = json_decode($cont, true);	89	$obj = json_decode($cont, true);
90	if (!$obj) return false;	90	if (!$obj) return false;
91		91
92	if (!isset($obj['items'])) return false;	92	if (!isset($obj['items'])) return false;
93		93
94	foreach ($obj['items'] as $item) {	94	foreach ($obj['items'] as $item) {
95	if ($item['kind'] == 'youtube#channel') {	95	if ($item['kind'] == 'youtube#channel') {
96	return array($item['id'], $item['statistics']);	96	return array($item['id'], $item['statistics']);
97	}	97	}
98	}	98	}
99	}	99	}
100		100
101	function yt_get_channel_stats($channel_id) {	101	function yt_get_channel_stats($channel_id) {
102	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&id='.urlencode($channel_id).'&part=statistics');	102	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/channels?key='.urlencode(yt_get_apikey()).'&id='.urlencode($channel_id).'&part=statistics');
103	if (!$cont) return false;	103	if (!$cont) return false;
104		104
105	$obj = json_decode($cont, true);	105	$obj = json_decode($cont, true);
106	if (!$obj) return false;	106	if (!$obj) return false;
107		107
108	if (!isset($obj['items'])) return false; //totalResults could be 0	108	if (!isset($obj['items'])) return false; //totalResults could be 0
109		109
110	foreach ($obj['items'] as $item) {	110	foreach ($obj['items'] as $item) {
111	if ($item['kind'] == 'youtube#channel') {	111	if ($item['kind'] == 'youtube#channel') {
112	return $item['statistics'];	112	return $item['statistics'];
113	}	113	}
114	}	114	}
115	}	115	}
116		116
117	function yt_get_playlist_stats($playlist_id) {	117	function yt_get_playlist_stats($playlist_id) {
118	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/playlists?part=contentDetails&id='.urlencode($playlist_id).'&key='.urlencode(yt_get_apikey()));	118	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/playlists?part=contentDetails&id='.urlencode($playlist_id).'&key='.urlencode(yt_get_apikey()));
119	if (!$cont) return false;	119	if (!$cont) return false;
120		120
121	$obj = json_decode($cont, true);	121	$obj = json_decode($cont, true);
122	if (!$obj) return false;	122	if (!$obj) return false;
123		123
124	if (!isset($obj['items'])) return false;	124	if (!isset($obj['items'])) return false;
125		125
126	foreach ($obj['items'] as $item) {	126	foreach ($obj['items'] as $item) {
127	if ($item['kind'] == 'youtube#playlist') {	127	if ($item['kind'] == 'youtube#playlist') {
128	if (!isset($item['contentDetails']) \|\| is_null($item['contentDetails'])) return false; // can happen to deleted playlists	128	if (!isset($item['contentDetails']) \|\| is_null($item['contentDetails'])) return false; // can happen to deleted playlists
129	return $item['contentDetails'];	129	return $item['contentDetails'];
130	}	130	}
131	}	131	}
132	}	132	}
133		133
134	function yt_channel_items($channel_id, $searchterms='', $maxresults=-1) {	134	function yt_channel_items($channel_id, $searchterms='', $maxresults=-1) {
135	$out = array();	135	$out = array();
136		136
137	$next_page_token = '';	137	$next_page_token = '';
138		138
139	do {	139	do {
140	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/search?part=snippet&channelId='.urlencode($channel_id).(($searchterms!='') ? '&q='.urlencode($searchterms) : '').'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));	140	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/search?part=snippet&channelId='.urlencode($channel_id).(($searchterms!='') ? '&q='.urlencode($searchterms) : '').'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));
141	if (!$cont) return false;	141	if (!$cont) return false;
142		142
143	$obj = json_decode($cont, true);	143	$obj = json_decode($cont, true);
144	if (!$obj) return false;	144	if (!$obj) return false;
145		145
146	if (!isset($obj['items'])) return false;	146	if (!isset($obj['items'])) return false;
147		147
148	foreach ($obj['items'] as $item) {	148	foreach ($obj['items'] as $item) {
149	if ($item['id']['kind'] == 'youtube#video') {	149	if ($item['id']['kind'] == 'youtube#video') {
150	$title = $item['snippet']['title'];	150	$title = $item['snippet']['title'];
151	$video_id = $item['id']['videoId'];	151	$video_id = $item['id']['videoId'];
152	$out[] = array($video_id, $title);	152	$out[] = array($video_id, $title);
153	if (($maxresults != -1) && ($maxresults == count($out))) return $out;	153	if (($maxresults != -1) && ($maxresults == count($out))) return $out;
154	}	154	}
155	}	155	}
156		156
157	$next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';	157	$next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';
158	} while ($next_page_token != '');	158	} while ($next_page_token != '');
159		159
160	return $out;	160	return $out;
161	}	161	}
162		162
163	// Acceptable order values are: date, rating, relevance(default), title, videoCount, viewCount	163	// Acceptable order values are: date, rating, relevance(default), title, videoCount, viewCount
164	function yt_search_items($searchterms, $order='', $maxresults=-1) {	164	function yt_search_items($searchterms, $order='', $maxresults=-1) {
165	$out = array();	165	$out = array();
166		166
167	$next_page_token = '';	167	$next_page_token = '';
168		168
169	do {	169	do {
170	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/search?part=snippet&q='.urlencode($searchterms).(($order!='') ? '&order='.urlencode($order) : '').'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));	170	$cont = @file_get_contents('https://www.googleapis.com/youtube/v3/search?part=snippet&q='.urlencode($searchterms).(($order!='') ? '&order='.urlencode($order) : '').'&maxResults=50'.(($next_page_token!='') ? '&pageToken='.urlencode($next_page_token) : '').'&key='.urlencode(yt_get_apikey()));
171	if (!$cont) return false;	171	if (!$cont) return false;
172		172
173	$obj = json_decode($cont, true);	173	$obj = json_decode($cont, true);
174	if (!$obj) return false;	174	if (!$obj) return false;
175		175
176	if (!isset($obj['items'])) return false;	176	if (!isset($obj['items'])) return false;
177		177
178	foreach ($obj['items'] as $item) {	178	foreach ($obj['items'] as $item) {
179	if ($item['id']['kind'] == 'youtube#video') {	179	if ($item['id']['kind'] == 'youtube#video') {
180	$title = $item['snippet']['title'];	180	$title = $item['snippet']['title'];
181	$video_id = $item['id']['videoId'];	181	$video_id = $item['id']['videoId'];
182	$out[] = array($video_id, $title);	182	$out[] = array($video_id, $title);
183	if (($maxresults != -1) && ($maxresults == count($out))) return $out;	183	if (($maxresults != -1) && ($maxresults == count($out))) return $out;
184	}	184	}
185	}	185	}
186		186
187	$next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';	187	$next_page_token = isset($obj['nextPageToken']) ? $obj['nextPageToken'] : '';
188	} while ($next_page_token != '');	188	} while ($next_page_token != '');
189		189
190	return $out;	190	return $out;
191	}	191	}
192		192
193	function getVideoIDFromURL($url) {	193	function getVideoIDFromURL($url) {
194	// Extract video ID from the URL	194	// Extract video ID from the URL
195		195
196	$vid = false;	196	$vid = false;
197	$m = null;	197	$m = null;
198		198
199	# Usual format	199	# Usual format
200	if (($vid === false) && (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/watch(.*)(/\|&\|\\?)v=([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {	200	if (($vid === false) && (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/watch(.*)(/\|&\|\\?)v=([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {
201	$vid = $m[4];	201	$vid = $m[4];
202	}	202	}
203		203
204	# Short format	204	# Short format
205	if (($vid === false) && (preg_match("@https{0,1}://(www\\.\|)youtu\\.be/([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {	205	if (($vid === false) && (preg_match("@https{0,1}://(www\\.\|)youtu\\.be/([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {
206	$vid = $m[2];	206	$vid = $m[2];
207	}	207	}
208		208
209	# YouTube "Shorts"	209	# YouTube "Shorts"
210	if (($vid === false) && (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/shorts/([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {	210	if (($vid === false) && (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/shorts/([a-zA-Z0-9_-]{11})@ismU", $url, $m))) {
211	$vid = $m[2];	211	$vid = $m[2];
212	}	212	}
213		213
214	return $vid;	214	return $vid;
215	}	215	}
216		216
217	function getPlaylistIDFromURL($url) {	217	function getPlaylistIDFromURL($url) {
218	$pid = false;	218	$pid = false;
219		219
220	# Usual format	220	# Usual format
221	$m = null;	221	$m = null;
222	if (($pid === false) && (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/(.*)(/\|&\|\\?)list=(.+)&@ismU", $url.'&', $m))) {	222	if (($pid === false) && (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/(.*)(/\|&\|\\?)list=(.+)&@ismU", $url.'&', $m))) {
223	$pid = $m[4];	223	$pid = $m[4];
224	}	224	}
225		225
226	return $pid;	226	return $pid;
227	}	227	}
228		228
229	function yt_check_apikey_syntax($apikey) {	229	function yt_check_apikey_syntax($apikey) {
230	return preg_match('@^[a-zA-Z0-9]{39}$@', $apikey);	230	return preg_match('@^[a-zA-Z0-9]{39}$@', $apikey);
231	}	231	}
232		232
233	function yt_check_video_id($video_id) {	233	function yt_check_video_id($video_id) {
234	return preg_match('@^[a-zA-Z0-9\-_]{11}$@', $video_id);	234	return preg_match('@^[a-zA-Z0-9\-_]{11}$@', $video_id);
235	}	235	}
236		236
237	function yt_get_channel_id_from_custom_url($custom_url) {	237	function yt_get_channel_id_from_custom_url($custom_url) {
238	// TODO: is there any API possibility??? API only accepts username and id ?!	238	// TODO: is there any API possibility??? API only accepts username and id ?!
239		239
240	// https://www.youtube.com/c/SASASMR	240	// https://www.youtube.com/c/SASASMR
241	// <link rel="canonical" href="https://www.youtube.com/channel/UCp4LfMtDfoa29kTlLnqQ5Mg">	241	// <link rel="canonical" href="https://www.youtube.com/channel/UCp4LfMtDfoa29kTlLnqQ5Mg">
242	// https://www.youtube.com/impaulsive	242	// https://www.youtube.com/impaulsive
243	// <link rel="canonical" href="https://www.youtube.com/channel/UCGeBogGDZ9W3dsGx-mWQGJA">	243	// <link rel="canonical" href="https://www.youtube.com/channel/UCGeBogGDZ9W3dsGx-mWQGJA">
-		244	// https://www.youtube.com/@KosmonautMusicSpecials
-		245	// <link rel="canonical" href="https://www.youtube.com/channel/UCayYOQ0DEIpcTgO9z_b-K1A">
244		246
245	$cont = @file_get_contents($custom_url);	247	$cont = @file_get_contents($custom_url);
246	if ($cont === false) {	248	if ($cont === false) {
247	throw new Exception("Cannot open $custom_url using file_get_contents.");	249	throw new Exception("Cannot open $custom_url using file_get_contents.");
248	}	250	}
249	if (!preg_match('@<link rel="canonical" href="https://www.youtube.com/channel/([^"]+)">@ismU', $cont, $m)) {	251	if (!preg_match('@<link rel="canonical" href="https://www.youtube.com/channel/([^"]+)">@ismU', $cont, $m)) {
250	return false;	252	return false;
251	}	253	}
252		254
253	return $m[1];	255	return $m[1];
254	}	256	}
255		257
256	function yt_get_channel_id_from_url($channel_url) {	258	function yt_get_channel_id_from_url($channel_url) {
257	$m = null;	259	$m = null;
258	if (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/user/(.*)(/\|&\|\\?)@ismU", $channel_url.'&', $m)) {	260	if (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/user/(.*)(/\|&\|\\?)@ismU", $channel_url.'&', $m)) {
259	// Username (deprecated feature. Not every channel has a username associated with it)	261	// Username (deprecated feature. Not every channel has a username associated with it)
260	// https://www.youtube.com/user/USERNAME	262	// https://www.youtube.com/user/USERNAME
261	$username = $m[2];	263	$username = $m[2];
262	$channel_id = yt_get_channel_id($username);	264	$channel_id = yt_get_channel_id($username);
263	return $channel_id;	265	return $channel_id;
264	} else if (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/channel/(.*)(/\|&\|\\?)@ismU", $channel_url.'&', $m)) {	266	} else if (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/channel/(.*)(/\|&\|\\?)@ismU", $channel_url.'&', $m)) {
265	// Real channel ID	267	// Real channel ID
266	// https://www.youtube.com/channel/ID	268	// https://www.youtube.com/channel/ID
267	$channel_id = $m[2];	269	$channel_id = $m[2];
268	return $channel_id;	270	return $channel_id;
269	} else if (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/(c/){0,1}(.*)(/\|&\|\\?)@ismU", $channel_url.'&', $m)) {	271	} else if (preg_match("@https{0,1}://(www\\.\|)youtube\\.com/(c/){0,1}(.*)(/\|&\|\\?)@ismU", $channel_url.'&', $m)) {
270	// Channel custom URL	272	// Channel custom URL
271	// https://www.youtube.com/NAME or https://www.youtube.com/c/NAME	273	// https://www.youtube.com/NAME or https://www.youtube.com/c/NAME
272	return yt_get_channel_id_from_custom_url($channel_url);	274	return yt_get_channel_id_from_custom_url($channel_url);
273	} else {	275	} else {
274	return false;	276	return false;
275	}	277	}
276	}	278	}
277		279
278	// Examples:	280	// Examples:
279	//yt_set_apikey(trim(file_get_contents(__DIR__ . '/.yt_api_key')));	281	//yt_set_apikey(trim(file_get_contents(__DIR__ . '/.yt_api_key')));
280	//print_r(yt_playlist_items('PL9GbGAd-gY1pyxZJIX5MOdYdRbdweVAID'));	282	//print_r(yt_playlist_items('PL9GbGAd-gY1pyxZJIX5MOdYdRbdweVAID'));
281	//print_r(yt_channel_items('UCjPjcMEAN64opOoNQE9GykA'));	283	//print_r(yt_channel_items('UCjPjcMEAN64opOoNQE9GykA'));
282	//print_r(yt_channel_items('UCjPjcMEAN64opOoNQE9GykA', 'Knight'));	284	//print_r(yt_channel_items('UCjPjcMEAN64opOoNQE9GykA', 'Knight'));
283	//print_r(yt_search_items('Wesley Willis', 'date', 10));	285	//print_r(yt_search_items('Wesley Willis', 'date', 10));
284		286