Get nicovideo's video metadata.
Project description
nicovideo.py
What's this
ニコニコ動画に投稿された動画の情報を取得するライブラリです。動画をダウンロードすることはできません。
使い方
初期設定
Python3を使える環境を作り、cloneしたらrequirements.txtから依存モジュールをインストールしてください。
python3 -m pip install -r requirements.txt
情報取得
このようにすると、動画の情報を取得できます。
import nicovideo
video = nicovideo.Video('動画ID')
metadata = video.get_metadata()['data']
クラス・関数やその返り値など
凡例:
class クラス名(初期化時の引数: 型ヒント = デフォルト値, ...)
def 関数名(引数: 型ヒント = デフォルト値, ...) -> 返り値型ヒント
def Video.get_metadata(videoid: str, return_rawdict: bool = False, use_cache: bool = False) -> ...
動画のメタデータを取得する関数です。
返り値:
# return_rawdictがTrueの場合:
{
"data": 指定された動画の動画情報のパース結果(Video.Metadata),
"rawdict": パース前のウェブサイトから直接取得したデータ(dict)
}
# return_rawdictが未指定/Falseの場合:
指定された動画の動画情報のパース結果(Video.Metadata)
class Video(videoid: str = 動画ID)
動画のクラスです。このクラスはネストされた物を含めてすべてget_metadata()
が管理するので、基本的には手動で初期化することはありません。
class Video.Metadata(...)
動画のメタデータを格納するクラスです。get_metadata()
の返り値に含まれます。
インスタンス変数一覧:
videoid : str = 動画ID
title : str = 動画タイトル
description: str = 動画概要
owner : Video.Metadata.User = 投稿者
counts : Video.Metadata.Counts = 各種カウンター
duration : int = 動画長(秒)
postdate : datetime.datetime = 投稿日時
genre : Optional[Video.Metadata.Genre] = ジャンル
tags : list[Video.Metadata.Tag] = タグ一覧
ranking : Video.Metadata.Ranking = ランキングデータ
series : Optional[Video.Metadata.Series] = シリーズ
thumbnail : Video.Metadata.Thumbnail = サムネイル
url : str = 視聴URL
class Video.Metadata.User(...)
ユーザーのクラスです。投稿者などを表します。
インスタンス変数一覧:
nickname: str = ユーザーニックネーム
userid : int = ユーザーID
class Video.Metadata.Counts(...)
各種カウンターのクラスです。再生数などのカウンターを表します。
インスタンス変数一覧:
comments: int = コメント数
likes : int = いいね!数
mylists : int = マイリスト数
views : int = 再生数
class Video.Metadata.Genre(...)
ジャンルのクラスです。
インスタンス変数一覧:
label: str = ジャンル名
key : str = ジャンルの内部識別キー
class Video.Metadata.Tag(...)
タグのクラスです。
インスタンス変数一覧:
name : str = タグ名
locked: bool = タグロック
class Video.Metadata.Ranking(...)
ランキングのクラスです。
インスタンス変数一覧:
genreranking: Union[Video.Metadata.Ranking.Genre, NoneType] = ジャンルのランキング情報
tagrankings : list[Video.Metadata.Ranking.Tag] = タグ別のランキング情報
class Video.Metadata.Ranking.Genre(...)
ジャンル別ランキングを格納するクラスです。
インスタンス変数一覧:
genre: Video.Metadata.Genre = ジャンル
rank : int = ランキング最高順位
time : datetime.datetime = 順位獲得日時
class Video.Metadata.Ranking.Tag(...)
タグ別ランキングを格納するクラスです。
インスタンス変数一覧:
tag : Video.Metadata.Tag = タグ
rank: int = ランキング最高順位
time: datetime.datetime = 順位獲得日時
Class Video.Metadata.Series(...)
シリーズのクラスです。
seriesid : int = シリーズID
title : str = シリーズタイトル
description: str = シリーズ概要
thumbnail : str = サムネイルURL
prev_video : Union[Video, NoneType] = 前動画
next_video : Union[Video, NoneType] = 次動画
first_video: Union[Video, NoneType] = 最初の動画
Class Video.Metadata.Thumbnail(...)
サムネイル画像のクラスです。
small_url : str = サムネイル(小)URL
middle_url: str = サムネイル(中)URL
large_url : str = サムネイル(大)URL
player_url: str = サムネイル(プレイヤー用)URL
ogp_url : str = サムネイル(OGP表示用)URL
License
適用ライセンス: LGPL 3.0
Copyright © 2023 okaits#7534
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nicovideo.py-2.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f77032b02b460de44c15ba74b08fd73cf9f68aeebfa3d7d53b4be07269b469ab |
|
MD5 | 4e57baba9cffb49109f08857486e2724 |
|
BLAKE2b-256 | b8b619f8a29f02287bbf7af67b1d3e2a11b1903363273a7ff4431924f05e9ee6 |