ニコニコの新検索の特徴:生放送編

追記 2015年12月16日
2015年11月にこの記事の方法は非推奨になったのでコンテンツ検索API V2を使う。
コンテンツ検索API V2 について

新検索β | niconico

前回記事:ニコニコの新検索の特徴:動画編

2014年11月17日の昼くらいから1601件目以降を選択("from":1601)すると 301 エラーが返ってきて応答がない不具合があり報告済みだがまだ直っていない。その後はドキュメントでも1600までとなったので不具合ではなく仕様になった。

特徴


基本的なことは動画と同じだが、json 形式からの検索では来場者数、コメント数、TS予約数、コミュIDでの検索が可能になるので、ニコ生データの取得に大きく貢献できる。ただしユーザー生放送はTS期間を過ぎると返事がなくなる点は今までの検索と同じ。

2014年1月24日あたりで来場者数のデータは調べられなくなったが現在は調べられる。
新検索β のAPI検索でニコ生の来場者数の返事が返ってこなくなる

仕様書


niconicoコンテンツの横断検索APIを「Mashup Awards 9」「ソーシャルかぶコン2013」に提供:dwango エンジニア ブロマガ:ドワンゴ研究開発チャンネル(ドワンゴグループのエンジニア) - ニコニコチャンネル:生活
Mashup Awards 9及び関連イベント向け提供APIガイド

2014/04/09 よりリダイレクトされるようになった
HTML5 Japan Cup向け提供APIガイド

2014/8/13 よりリダイレクトされるようになった
Mashup Awards 10向け提供APIガイド
POST先:http://api.search.nicovideo.jp/api/

POST
{
"filters": [
{
"field": "ss_adult",
"type": "equal",
"value": false
},
{
"field": "live_status", // ステータス
"type": "equal",
"value": "onair" // onair, reserved, past / 放送中 放送予定 放送終了 規定値は全部
},
{
"field": "provider_type", // 放送者の種類 規定値は全部
"type": "equal",
"value": "official" // official, channel, community
},
{
"field": "start_time", // 放送開始日時と終了日時
"from": "2013-07-21 00:00:00",
"include_lower": true, // true, false / from 値を含むかどうか 規定値は true
"include_upper": true, // true, false / to 値を含むかどうか 規定値は true
"to": "2013-08-04 23:59:59",
"type": "range" // ユーザー生放送の場合、タイムシフト期間(7日)を外れると結果は 0
},
{
"field": "timeshift_enabled", // タイムシフト視聴可能の可否
"type": "equal",
"value": true // true, false タイムシフト視聴可能だけ、タイムシフト視聴不可も含む
},
{
"field": "member_only", // コミュニティ限定番組を表示
"type": "equal",
"value": true // true, false / する、しない 規定値は表示する
},
{
"field": "view_counter", // 来場者数、ウェブ上ではない仕様 使えなくなった
"from": "1000",
"include_lower": true,
"include_upper": true,
"to": "2000",
"type": "range"
},
{
"field": "comment_counter", // コメント数、ウェブ上ではない仕様
"from": "100",
"include_lower": true,
"include_upper": true,
"to": "300",
"type": "range"
},
{
"field": "score_timeshift_reserved", // TS予約数、ウェブ上ではない仕様
"from": "100",
"include_lower": true,
"include_upper": true,
"to": "200",
"type": "range"
},
{
"field": "community_id", // コミュID、ウェブ上ではない仕様
"from": "1",
"include_lower": true,
"include_upper": true,
"to": "10000",
"type": "range"
}
],
"from": 0, // 開始番号 0なら最初から 100なら101件目から
"issuer": "pc", // モバイル端末だと sp : "サービス/アプリケーション名"を明記
"join": [ // これらの内容の返事がある
"cmsid",
"title",
"description",
"community_id",
"community_icon",
"open_time",
"start_time",
"live_end_time",
"view_counter", // 使うとエラーにならなくなった 2014/07/06 確認
"comment_counter",
"score_timeshift_reserved",
"provider_type",
"channel_id",
"live_status",
"timeshift_enabled",
"tags", // これを追加すると返事にタグが付いてくる
"member_only"
],
"order": "desc", // desc, asc / 昇順 降順
"query": "町会議", // 検索キーワード
"reason": "ma10",
"search": [
"title",
"description",
"tags" // タグ検索は tags だけ、キーワード検索はこの3つ全部
],
"service": [
"live" // サービス識別子 live, video, illust, manga, book, channel, channelarticle, news
],
"size": 25, // 1ページに表示する件数。1 から 100 まで。PCは25件、モバイルは15件
"sort_by": "_popular", // 並び替えの基準となるフィールド名
/ _popular, _live_recent, score_timeshift_reserved, view_counter, comment_counter, community_level, community_created
"timeout": 10000 // タイムアウト時間、多分ミリ秒
}


cURL のサンプルコマンド(トリプルクリックで全選択できます)
curl -v "Accept: application/json" -H "Content-type: application/json" -X POST -d '{"query":"一般(その他)","service":["live"],"search":["tags"],"join":["cmsid","title","description","community_id","thumbnail_url","community_icon","open_time","start_time","live_end_time","comment_counter","view_counter","score_timeshift_reserved","channel_id","provider_type","live_status","tags","member_only"],"filters":[{"type":"equal","field":"live_status","value":"past"},{"type":"equal","field":"provider_type","value":"community"}],"sort_by":"score_timeshift_reserved","order":"desc","from":0,"size":1,"issuer":"apiguide","reason":"ma10"}' http://api.search.nicovideo.jp/api/


GET
join を1つだけにした場合は返事が一つの配列に入っているが、2つ以上の場合は最大で4分割される
[
{
"_rowid": 0, // 何番目の表示
"channel_id": false, // チャンネル生放送だけチャンネル番号が返ってくる。それ以外は false
"cmsid": "lv146590425", // 放送番号
"comment_counter": 2038, // コメント数
"community_icon": "http://icon.nimg.jp/community/s/1/co17396.jpg", // サムネURL
"community_id": 17396, // コミュニティ生放送だけコミュニティ番号が返ってくる。それ以外は false
"description": "ニコニコ町会議で香川県の琴平町に来ています。 // 放送説明文
"live_end_time": "2013-07-27 15:13:00", // 放送終了時間
"live_status": "past", // 放送状態
"member_only": 0, // コミュ限であるかどうか
"timeshift_enabled": 1, // タイムシフト予約が可能かどうか
"open_time": false,
"provider_type": "community", // 配信形態
"score_timeshift_reserved": 161, // TS予約数
"start_time": "2013-07-27 12:58:00", // 放送開始時間
"tags": "一般(その他) 顔出し 一般 驚きの白さ おとーしゃ 愛されてるおとーしゃ", // タグ
"title": "ニコニコ町会議in香川 繚乱たこ焼き屋前", // 放送タイトル
"view_counter": 2941 // 来場者数
}
]
関連記事

コメント

非公開コメント

プロフィール

ロベルト

お問い合わせはこちらまで
robelt2525[at]gmail.com

中の人 @nico_lab

広告リンク
Amazon
楽天市場

ブログ更新用 @blo_nico_lab

詳しいプロフィールはこちら

当ブログは、Amazonアソシエイトに参加しています。