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
 *                )
 *        )
 * )
 */

incremental / php-youtube

Maintainers

Details