これはYouTube Data API (v3)を使用した動画やチャンネルを検索する方法に関する記事です。

 

基本構文は以下の通りです。

構文

https://www.googleapis.com/youtube/v3/search

 

基本構文に対してパラメータを付与する必要があります。

必須パラメータ

part

part名によってレスポンスの内容を変更することが出来ます。

partは以下を指定することが出来ます。

id、snippet

snippetを指定すると詳細な情報を取得できます。

 

その他省略可能なパラメータ

type, order, q, ...

typeにはchannel, playlist, videoを指定できます。typeを指定することでレスポンスが動画なのかチャンネルなのかが変わります。

orderは表示順を指定できます。

viewCountを指定すれば再生回数の多い順、dateを指定すれば作成日の新しい順に取得できます。

（※orderに関してはtypeをchannelにして実際に試したところ取得のたびに結果が異なってしまいました。原因が分かる方がいたら記載をお願いします。）

qには検索ワードを指定できます。

 

以下、例文です。

ゲームというキーワードで動画を取得しています。

例文

https://www.googleapis.com/youtube/v3/search
?part=snippet
&maxResults=1
&q=ゲーム
&type=video
&key=【APIキー】

 

以下、例文のレスポンスです。

レスポンス
{
 "kind": "youtube#searchListResponse",
 "etag": "\"ld9biNPKjAjgjV7EZ4EKeEGrhao/4dI2RGjjdR8Xj1QdYiubgg5cVoM\"",
 "nextPageToken": "CAEQAA",
 "regionCode": "JP",
 "pageInfo": {
  "totalResults": 1000000,
  "resultsPerPage": 1
 },
 "items": [
  {
   "kind": "youtube#searchResult",
   "etag": "\"ld9biNPKjAjgjV7EZ4EKeEGrhao/p16ohTtnXJkVcAwAG7SytmUSYRM\"",
   "id": {
    "kind": "youtube#video",
    "videoId": "1XMWpkjIpXU"
   },
   "snippet": {
    "publishedAt": "2017-10-26T13:49:19.000Z",
    "channelId": "UCvnqLqG_V2EU-JAqgs2icGg",
    "title": "このすば この欲深いゲームに審判を！  ウィズは膝枕+耳かきの豪華なご褒美",
    "description": "この欲深いゲームに審判を！ 『PS4』 ウィズCV:＃堀江由衣 自分の中の代表作アニメで例えると、『とらドラ！』 歌は『Stand Up!、インモラリストetc....",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/1XMWpkjIpXU/default.jpg",
      "width": 120,
      "height": 90
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/1XMWpkjIpXU/mqdefault.jpg",
      "width": 320,
      "height": 180
     },
     "high": {
      "url": "https://i.ytimg.com/vi/1XMWpkjIpXU/hqdefault.jpg",
      "width": 480,
      "height": 360
     }
    },
    "channelTitle": "クウェイス Qweyse",
    "liveBroadcastContent": "none"
   }
  }
 ]
}

 

指定できるパラメータのリストはこちらを参照してください。