プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
iQIYIの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードでiQIYIの番組や動画を検索します。カテゴリ、公開期間、画質、配信元サイトでの絞り込みや並べ替えが可能で、再生時間、人気度、評価、シリーズ、出演者が含まれます。heat_countはiQIYI独自の人気スコアで、再生回数ではなく、他のプラットフォームとは比較できません。 | 1,000リクエストあたり$1.39 | 正常 |
動画の詳細video | 1件の動画の再生URLをurlに指定して、iQIYIの動画詳細をJSONで取得します。レコードにはタイトル、カテゴリ、再生時間、公開日、人気度、評価、シリーズ情報、出演者、投稿者が含まれます。単一動画の再生リンクを渡してください。シリーズページとクリエイターのプロフィールには対応していません。シリーズを探すにはalbumを使ってください。 | 1,000リクエストあたり$1.39 | 正常 |
アルバムalbum | タイトルまたは出演者名で、iQIYI国際版のカタログからシリーズや映画を検索します。エピソード一覧、総エピソード数と視聴可能なエピソード数、年、公開日、評価、視聴年齢区分を取得できます。カタログはregionで選んだライブラリによって異なります。再生できることは保証されません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
iQIYIの各アクションではどのような入力を指定できますか?
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードでiQIYIの番組や動画を検索します。カテゴリ、公開期間、画質、配信元サイトでの絞り込みや並べ替えが可能で、再生時間、人気度、評価、シリーズ、出演者が含まれます。 | keyword | category, publish_date, published, quality, scrape_additional_info, site, sort | Sync配信 | カタログ値:defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · category · category_id · duration_seconds · duration_sec · heat_count · rating · rating_scale · rating_count · like_count · comment_count · collect_count · album_id · album_title · album_url · album_episode_count · image_url · wide_image_url · author_name · author_id · author_avatar_url · author_follower_count · author_video_count · author_location · author_org · posted_at · platform · cast |
video動画の詳細 1件の動画の再生URLを | url | scrape_additional_info | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · text · category · category_id · duration_seconds · duration_sec · heat_count · rating · rating_scale · rating_count · like_count · comment_count · collect_count · album_id · album_title · album_url · album_episode_count · image_url · wide_image_url · author_name · author_id · author_avatar_url · author_follower_count · author_video_count · author_location · author_org · posted_at · platform · cast |
albumアルバム タイトルまたは出演者名で、iQIYI国際版のカタログからシリーズや映画を検索します。エピソード一覧、総エピソード数と視聴可能なエピソード数、年、公開日、評価、視聴年齢区分を取得できます。カタログは | keyword | lang, language, region | Sync配信 | カタログ値:defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · play_url · title · subtitle · type · is_series · year · release_date · duration_seconds · duration_sec · rating · rating_scale · content_rating · episode_count · episode_available_count · image_url · episodes · cast · platform |
iQIYIのsearchのパラメータはそれぞれどういう意味ですか?
キーワードでiQIYIの番組や動画を検索します。カテゴリ、公開期間、画質、配信元サイトでの絞り込みや並べ替えが可能で、再生時間、人気度、評価、シリーズ、出演者が含まれます。heat_countはiQIYI独自の人気スコアで、再生回数ではなく、他のプラットフォームとは比較できません。
keyword必須- searchアクションでは検索語を、国際版のalbumアクションではシリーズ名、アルバム名、出演者名を指定します。albumアクションはアルバムのURLから直接詳細を取得するものではなく、利用できるコンテンツライブラリは地域によって異なります。iQIYI:コンテンツの人気度とサイト内再生回数の違い — iQIYIの2018年の発表では、コンテンツの人気度を視聴、インタラクション、シェアを含む複合指標として説明し、再生回数とは区別しています。これはheat_countの指標の種類を説明するものにすぎず、現在のアルゴリズムやしきい値、プラットフォーム間の比較可能性を推定するものではありません。また、人気度から実際の再生回数を推測するものでもありません。 · 確認日
category任意- 動画コンテンツをカテゴリで絞り込みます。指定できる値はmovie、tv_series、variety_shows、animation、documentary、advertisement、beauty、car、comedy、entertainment、fashion、finance、game、health、life、military、mother_baby、music、news_info、originals、short_films、sports、square_dance、talk_shows、technology、trailers、travel、trending、またはall(制限なし)などです。このパラメータは大まかなカテゴリで絞り込むもので、出演者やシリーズのタグによる絞り込みではありません。指定可能な値:
advertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows publish_date任意- searchアクションの結果を公開時期で絞り込みます。all、last_24_hours、last_7_days、last_30_daysのいずれかを受け付けます。このフィールドはYYYY-MM-DD形式の日付を受け付けません。このフィールドとpublishedの両方がある場合は、publishedが優先されます。
published任意- searchアクションでpublish_dateより優先されます。all、last_24_hours、last_7_days、last_30_daysのいずれかを受け付けます。このフィールドは文字列フィルターであり、真偽値のtrue/falseは受け付けません。
quality任意- iQIYIの検索結果を、指定した動画画質で絞り込みます。主な値はall、hd、ultra_hd、720p、1080pです。ダウンロードやトランスコードのオプションではなく、一覧にない値は効果がない場合があります。
scrape_additional_info任意- iQIYIの検索結果に、投稿者やエンゲージメントの追加情報を含めるかどうかを指定します。JSONの真偽値を渡してください。デフォルトはtrueです。falseに設定すると追加の取得処理は行われませんが、EveryInfra APIの料金は変わりません。
site任意- searchで使用する配信元サイトの条件を指定します。主な値はall、iqiyi、tencent_video、sohu、youku、tudou、acfun、bilibili、ifeng、cntv、m1905です。検索結果をそれらのサイトに絞り込むもので、各サイトに詳細取得用のアクションがあることを意味するものではありません。
sort任意- 動画検索結果の並び順を指定します。relevance、newest、popularのいずれかを受け付けます。ユーザー評価やエピソードの公開順で並べ替えることはできず、単一の動画をリクエストする場合は効果がありません。指定可能な値:
newestpopularrelevance
iQIYIのvideoのパラメータはそれぞれどういう意味ですか?
1件の動画の再生URLをurlに指定して、iQIYIの動画詳細をJSONで取得します。レコードにはタイトル、カテゴリ、再生時間、公開日、人気度、評価、シリーズ情報、出演者、投稿者が含まれます。単一動画の再生リンクを渡してください。シリーズページとクリエイターのプロフィールには対応していません。シリーズを探すにはalbumを使ってください。
url必須- videoアクションで、iQIYIの動画再生ページの完全なURL(v_*.html形式)を受け付けます。シリーズ/アルバムページ(a_*.html)やクリエイターのプロフィールリンクには対応していません。シリーズを探す場合は、albumアクションでkeywordを使用してください。
scrape_additional_info任意- iQIYIの検索結果に、投稿者やエンゲージメントの追加情報を含めるかどうかを指定します。JSONの真偽値を渡してください。デフォルトはtrueです。falseに設定すると追加の取得処理は行われませんが、EveryInfra APIの料金は変わりません。
iQIYIのalbumのパラメータはそれぞれどういう意味ですか?
タイトルまたは出演者名で、iQIYI国際版のカタログからシリーズや映画を検索します。エピソード一覧、総エピソード数と視聴可能なエピソード数、年、公開日、評価、視聴年齢区分を取得できます。カタログはregionで選んだライブラリによって異なります。再生できることは保証されません。
keyword必須- searchアクションでは検索語を、国際版のalbumアクションではシリーズ名、アルバム名、出演者名を指定します。albumアクションはアルバムのURLから直接詳細を取得するものではなく、利用できるコンテンツライブラリは地域によって異なります。
lang任意- albumアクションのタイトル表示言語を、短縮コード(zhcn、zhtw、enus、jajp、arsa、eses、idid、kokr、msmy、thth、vivn)で設定します。このパラメータはローカライズされたメタデータのラベルを変更するもので、動画の字幕をリクエストしたり、コンテンツライブラリの地域を変更したりするものではありません。指定可能な値:
arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw language任意- albumアクションのタイトルのローカライズに使用する、互換用の言語コードを受け付けます。値はzh_cn(デフォルト)、zh_tw、en_us、id_id、ms_my、th_th、vi_vn、ko_kr、ja_jp、es_es、ar_saのいずれかです。このパラメータとlangの両方を指定した場合はlangが優先されます。2つのパラメータでコード形式を混在させないでください。指定可能な値:
ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw region任意- albumアクションのコンテンツライブラリの地域を選択します。値はintl(デフォルト)、vn、th、id、my、tw、ph、sg、kr、jpのいずれかで、それ以外の値を指定すると422が返されます。このパラメータはインターフェースの言語ではなく、地域別のメディアカタログを切り替えます。指定可能な値:
idintljpkrmyphsgthtwvniQIYI International:地域ごとの著作権制限と配信中のライブラリ — iQIYI Internationalのヘルプにある著作権制限に関するFAQでは、地域ごとのライセンスによってコンテンツを再生できない場合があること、外部の検索結果が配信中のライブラリを反映していない場合があることが説明されています。そのため、アルバムの地域オプションや取得したメタデータは再生できることを保証するものではなく、地域制限を回避する手段にはなおさらなりません。 · 確認日
iQIYI APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"iqiyi","action":"search","params":{"keyword":"<keyword>"}}'
iQIYI APIに関する質問
iQIYI APIでは何を取得できますか?
platformをiqiyiに設定します。現在のカタログには検索、動画の詳細、アルバムが掲載されています。これらのアクション名はそれぞれ異なるiQIYIのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
iQIYIのsearchリクエストを開始するには、どの入力を使用しますか?
searchアクションでは検索語を、国際版のalbumアクションではシリーズ名、アルバム名、出演者名を指定します。albumアクションはアルバムのURLから直接詳細を取得するものではなく、利用できるコンテンツライブラリは地域によって異なります。params内のkeywordとして送信してください。
iQIYIのsearchはどのフィールドを返しますか?
宣言されたスキーマにはtitle、text、category、category_idが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
iQIYIのアクションはすべて即座に結果を返しますか?
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。