README

PHP-YouTube

This library aims at providing an easy-to-use wrapper for the non-OAuth YouTube API (v3) endpoints.

Supported actions

• youtube.activities.list
• youtube.channels.list
• youtube.channelSections.list
• youtube.comments.list
• youtube.commentThreads.list
• youtube.guideCategories.list
• youtube.18nLanguages.list
• youtube.18nRegions.list
• youtube.playlistItems.list
• youtube.playlists.list
• youtube.search.list
• youtube.subscriptions.list
• youtube.videocategories.list
• youtube.videos.list

youtube.activities.list

Returns a list of channel activity events that match the given channel id.

For more information, take a look at https://developers.google.com/youtube/v3/docs/activities/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listActivities([ 'part' => 'id', 'channelId' => 'UCVHFbqXqoYvEWM1Ddxl0QDg', 'maxResults' => 1 ]); print_r($response); /**  * Array  * (  * [kind] => youtube#activityListResponse  * [etag] => "eYE31WLho912TfxEBDDRSwEQ5Ms/LZ35K6cHrk3gvAbMl22qG9gJzlk"  * [nextPageToken] => CAEQAA  * [pageInfo] => Array  * (  * [totalResults] => 9  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#activity  * [etag] => "eYE31WLho912TfxEBDDRSwEQ5Ms/WcC5XzEdaxXmLhsuZ1s9_CBqix8"  * [id] => VTE0MzQwNDMxMDYxNDAxNDY3MTQzNjM5MjA=  * )  * )  * )  */

youtube.channels.list

Returns a collection of zero or more channel resources that match the request criteria.

For more information, take a look at https://developers.google.com/youtube/v3/docs/channels/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listChannels([ 'part' => 'id', 'channelId' => 'GCQmVzdCBvZiBZb3VUdWJl', 'maxResults' => 1 ]); print_r($response); /**  * Array  * (  * [kind] => youtube#channelListResponse  * [etag] => "eYE31WLho912TfxEBDDRSwEQ5Ms/vScTfQD3jJn-MzW5d9kDHIJU61w"  * [nextPageToken] => CAEQAA  * [pageInfo] => Array  * (  * [totalResults] => 11  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#channel  * [etag] => "eYE31WLho912TfxEBDDRSwEQ5Ms/sgkeX05nlECWsuF-d1WorqhxJVQ"  * [id] => UCF0pVplsI8R5kcAqgtoRqoA  * )  * )  * )  */

youtube.channelsections.list

Returns a list of channelSection resources that match the request criteria.

For more information, take a look at https://developers.google.com/youtube/v3/docs/channelSections/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listChannelSections([ 'part' => 'id', 'channelId' => 'GCQmVzdCBvZiBZb3VUdWJl', ]); print_r($response); /**  * Array  * (  * [kind] => youtube#channelSectionListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/4JnIcJTNhW-8qjW5Xh2gRXpVNh8"  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#channelSection  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/Yf2NnAr2mk7seya0WwQIJgvb5H4"  * [id] => UCVHFbqXqoYvEWM1Ddxl0QDg.__WLXNpu6u8  * [snippet] => Array  * (  * [type] => singlePlaylist  * [style] => horizontalRow  * [channelId] => UCVHFbqXqoYvEWM1Ddxl0QDg  * [position] => 0  * )  * )  * )  * )  */

youtube.comments.list

Returns a list of comments that match the request criteria.

For more information, take a look at https://developers.google.com/youtube/v3/docs/comments/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listComments([ 'part' => 'id', 'channelId' => 'z131gtcqbqbft5y3x22jfvmoakf3ezfsi', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#commentListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/my2z1KHSZNVuD41bSHIrxgS8G-U"  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#comment  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/4Lac9A_R38HxodU7PaftM_J1BaY"  * [id] => z131gtcqbqbft5y3x22jfvmoakf3ezfsi  * )  * )  * )  */

youtube.commentthreads.list

Returns a list of comment threads that match the request criteria.

For more information, take a look at https://developers.google.com/youtube/v3/docs/commentThreads/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listCommentThreads([ 'part' => 'id', 'videoId' => 'z131gtcqbqbft5y3x22jfvmoakf3ezfsi', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#commentThreadListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/uN-iOCehYpos4TNPM5gjN8UB1xY"  * [nextPageToken] => Cg0Qr9vwvY3AxgIgACgBEhQIABDIrYirubDGAhjIrYirubDGAhgCIAE=  * [pageInfo] => Array  * (  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#commentThread  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/7sgGL5ZZoBDiABrwCZQ4HWh7TPs"  * [id] => z12lxfwxtzqwhdfrq04cgnqowyusftk4esk0k  * )  * )  * )  */

youtube.guidecategories.list

Returns a list of categories that can be associated with YouTube channels.

For more information, take a look at https://developers.google.com/youtube/v3/docs/guideCategories/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listGuideCategories([ 'part' => 'id', 'regionCode' => 'NL', ]); print_r($response); /**  * Array  * (  * [kind] => youtube#guideCategoryListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/MnjXoNFdOgOUSRqlgJ3cE1jYWvg"  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#guideCategory  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/ei31gUqEQxOtnflo47cy0YAa_MM"  * [id] => GCQmVzdCBvZiBZb3VUdWJl  * )  * )  * )  */

youtube.i18nLanguages.list

Returns a list of application languages that the YouTube website supports.

For more information, take a look at https://developers.google.com/youtube/v3/docs/i18nLanguages/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listI18nLanguages([ 'part' => 'id', ]); print_r($response); /**  * Array  * (  * [kind] => youtube#i18nLanguageListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/wD1Vj4GH0IYKZJOUyuxIoquCcHs"  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#i18nLanguage  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/8KwAGX0iEJffc-VyQgBD2mnlbac"  * [id] => af  * )  * )  * )  */

youtube.i18nRegions.list

Returns a list of content regions that the YouTube website supports.

For more information, take a look at https://developers.google.com/youtube/v3/docs/i18nRegions/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listI18nRegions([ 'part' => 'id', ]); print_r($response); /**  * Array  * (  * [kind] => youtube#i18nRegionListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/z8_sDbXXqFQ0QvdJ-9cH9JGf4o4"  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#i18nRegion  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/1K5qc4QfRqfgcFVQseK1hTW9b2c"  * [id] => US  * )  * )  * )  */

youtube.playlistItems.list

Returns a collection of playlist items that match the API request parameters. You can retrieve all of the playlist items in a specified playlist or retrieve one or more playlist items by their unique IDs.

For more information, take a look at https://developers.google.com/youtube/v3/docs/playlistItems/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listPlaylistItems([ 'part' => 'id', 'playlistId' => 'PLWz5rJ2EKKc9ofd2f-_-xmUi07wIGZa1c', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#playlistItemListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/hBziD0I-EcwiXydv0GDIrIg_tms"  * [nextPageToken] => CAEQAA  * [pageInfo] => Array  * (  * [totalResults] => 24  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#playlistItem  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/I3VVE1hQi9lf5TYMwq0PobNjGqo"  * [id] => PLqKOsfcZLLdlAo54wkuLqIjRo-SaPCQYyZicRPdwWWRg  * )  * )  * )  */

youtube.playlists.list

Returns a collection of playlists that match the API request parameters. For example, you can retrieve one or more playlists by their unique IDs.

For more information, take a look at https://developers.google.com/youtube/v3/docs/playlists/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listPlaylists([ 'part' => 'id', 'playlistId' => 'PLWz5rJ2EKKc9ofd2f-_-xmUi07wIGZa1c', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#playlistListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/rj5IqmLz71fFu6p4mMXlJmpJfxM"  * [nextPageToken] => CAEQAA  * [pageInfo] => Array  * (  * [totalResults] => 55  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#playlist  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/ZF8lhREd15KN22t7926-2iNFGd0"  * [id] => PLWz5rJ2EKKc-rru_xVZNamRDaQfHr6ebv  * )  * )  * )  */

youtube.search.list

Returns a collection of search results that match the query parameters specified in the API request. By default, a search result set identifies matching video, channel, and playlist resources, but you can also configure queries to only retrieve a specific type of resource.

For more information, take a look at https://developers.google.com/youtube/v3/docs/search/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listSearch([ 'part' => 'id', 'channelId' => 'UC_x5XG1OV2P6uZZ5FSM9Ttw', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#searchListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/G4Uurrtcf18axqH_LSyFmuhf2X4"  * [nextPageToken] => CAEQAA  * [pageInfo] => Array  * (  * [totalResults] => 3988  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#searchResult  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/q4hYefapiMoagc7b_3bYaVZvSJo"  * [id] => Array  * (  * [kind] => youtube#channel  * [channelId] => UC_x5XG1OV2P6uZZ5FSM9Ttw  * )  * )  * )  * )  */

youtube.subscriptions.list

Returns subscription resources that match the API request criteria.

For more information, take a look at https://developers.google.com/youtube/v3/docs/subscriptions/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listSubscriptions([ 'part' => 'id', 'channelId' => 'UC_x5XG1OV2P6uZZ5FSM9Ttw', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#subscriptionListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/Tjfg1JrIT4dfOWI4p2GAh62RkuM"  * [nextPageToken] => CAEQAA  * [pageInfo] => Array  * (  * [totalResults] => 44  * [resultsPerPage] => 1  * )  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#subscription  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/AMk7GKpqy6n7dqRBhb9OkS9yCrg"  * [id] => MpajmvGNexIkHC8F7y2fiZ-2BKHlv54sys7NqgqY_ak  * )  * )  * )  */

youtube.videocategories.list

Returns a list of categories that can be associated with YouTube videos.

For more information, take a look at https://developers.google.com/youtube/v3/docs/videoCategories/list.

<?php require_once('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listVideoCategories([ 'part' => 'id', 'regionCode' => 'NL', ]); print_r($response); /**  * Array  * (  * [kind] => youtube#videoCategoryListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/d2nxEqpmtIzd-HWoYLbxZeG5Ig8"  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#videoCategory  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/XLk_qpc4aA4EW__lDxBJzY9kMIg"  * [id] => 1  * )  * )  * )  */

youtube.videos.list

Returns a list of videos that match the API request parameters.

For more information, take a look at https://developers.google.com/youtube/v3/docs/videos/list.

<?php require_once ('vendor/autoload.php'); use Incremental\YouTube\YouTube; $youtube = new YouTube('YOUR_API_KEY'); $response = $youtube->listVideos([ 'part' => 'id', 'chart' => 'mostPopular', 'maxResults' => 1, ]); print_r($response); /**  * Array  * (  * [kind] => youtube#videoListResponse  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/5vKizhjk_5NDC69NYkSsP90NfQ4"  * [nextPageToken] => CAUQAA  * [pageInfo] => Array  * (  * [totalResults] => 30  * [resultsPerPage] => 1  * )  *  * [items] => Array  * (  * [0] => Array  * (  * [kind] => youtube#video  * [etag] => "Y3xTLFF3RLtHXX85JBgzzgp2Enw/D0_V-FNcsvu5O5nb4WVaywcVcNY"  * [id] => PLlMTn_Jzok  * )  * )  * )  */