プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Doubanの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | タイトルやテーマでDoubanの映画・書籍・アルバムを検索します。公開・出版・発売年、監督とキャスト、著者またはアーティスト、評価、評価者数、カバーを取得できます。search_typeで映画、書籍、音楽に絞り込めます。両方を指定した場合はtypeが優先されます。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | Doubanの作品リンクから、映画・書籍・アルバムの長文レビューを読み取ります。各レビューにはタイトル、本文、評価ラベル、レビュアー、返信数が含まれます。評価はそれぞれのレビューに紐づくものです。1回のバッチに作品のすべてのレビューが含まれるとは限りません。 | 1,000リクエストあたり$241件につき1回の呼び出しとして計上 | 正常 |
コメントcomments | Doubanの作品リンクから、映画・書籍・アルバムに寄せられた短評を一覧表示します。各短評にはテキスト、評価ラベル、投稿者、投票数、日付が含まれます。これらの短評は、reviewsが返す長文レビューとは別のものです。 | 1,000リクエストあたり$1.39 | 正常 |
グループのトピックgroup_topic | Doubanグループのディスカッションをトピックリンクから読み取ります。最初の投稿、グループ名とリンク、投稿者、返信数、返信を取得できます。max_repliesで取得する返信数を1〜100の範囲で指定します（デフォルトは20）。非公開グループにはアクセスできず、スレッドが不完全な場合があります。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Doubanの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 タイトルやテーマでDoubanの映画・書籍・アルバムを検索します。公開・出版・発売年、監督とキャスト、著者またはアーティスト、評価、評価者数、カバーを取得できます。 | keyword | search_type, type | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform |
reviewsレビュー Doubanの作品リンクから、映画・書籍・アルバムの長文レビューを読み取ります。各レビューにはタイトル、本文、評価ラベル、レビュアー、返信数が含まれます。評価はそれぞれのレビューに紐づくものです。1回のバッチに作品のすべてのレビューが含まれるとは限りません。 | url | — | Sync配信 | カタログ値：defaultLimit=15、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$241件につき1回の呼び出しとして計上 | id · url · subject_id · subject_name · subject_type · title · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · reply_count · posted_at · platform |
commentsコメント Doubanの作品リンクから、映画・書籍・アルバムに寄せられた短評を一覧表示します。各短評にはテキスト、評価ラベル、投稿者、投票数、日付が含まれます。これらの短評は、 | url | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · subject_id · subject_name · subject_type · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · vote_count · posted_at · platform |
group_topicグループのトピック Doubanグループのディスカッションをトピックリンクから読み取ります。最初の投稿、グループ名とリンク、投稿者、返信数、返信を取得できます。 | url | max_replies | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform |
Doubanのsearchのパラメータはそれぞれどういう意味ですか？
タイトルやテーマでDoubanの映画・書籍・アルバムを検索します。公開・出版・発売年、監督とキャスト、著者またはアーティスト、評価、評価者数、カバーを取得できます。search_typeで映画、書籍、音楽に絞り込めます。両方を指定した場合はtypeが優先されます。
keyword必須- Doubanの映画、書籍、音楽の作品を探すための、タイトルまたはトピックの検索キーワードを指定します。長文レビューやグループトピック内の全文検索は行いません。
search_type任意- 作品カテゴリの検索をall（デフォルト）、movie、book、musicのいずれかで絞り込みます。typeも同時に指定した場合はtypeが優先されます。認識できない値はallとして扱われます。指定可能な値:
allbookmoviemusic type任意- search_typeを上書きし、作品検索をカテゴリ（all、movie、book、music）で絞り込みます。絞り込むのはカタログ項目の種類のみで、reviews（長文レビュー）とcomments（短評）の切り替えには使いません。この2つはアクションの種類で決まります。指定可能な値:
allbookmoviemusicDouban Books：書籍の評価とレビューの範囲 — Douban Booksでは評価、長文レビュー、短評を区別しており、書籍の評価は他のフィードバックとあわせて考慮するよう勧めています。これは書籍エントリーの評価の背景を説明するものです。スコアを客観的な価値の尺度とするものではなく、ウェブサイト限定の機能をこのエンドポイントに追加するものでもありません。 · 確認日
Doubanのreviewsのパラメータはそれぞれどういう意味ですか？
Doubanの作品リンクから、映画・書籍・アルバムの長文レビューを読み取ります。各レビューにはタイトル、本文、評価ラベル、レビュアー、返信数が含まれます。評価はそれぞれのレビューに紐づくものです。1回のバッチに作品のすべてのレビューが含まれるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象のURLを指定します。reviewsまたはcommentsアクションではmovie.douban.com、book.douban.com、music.douban.com上の/subject/<ID>/形式、group_topicではwww.douban.com/group/topic/<ID>/形式です。長文レビュー、短評、グループトピックへの返信は、それぞれ別のアクションのエンドポイントで扱います。Douban Movies：長文レビュー、短評、表示範囲の制限 — Douban Moviesでは映画レビューと短評を分けて説明しており、短評欄にはすべての短評が表示されるわけではなく、折りたたまれたコンテンツは公開範囲が異なると注記しています。このエンドポイントが返す映画レビューの一覧を、完全な履歴や観客全体の意見と捉えないでください。また、この情報源は書籍や音楽に関する個別のルールに代わるものではありません。 · 確認日
Doubanのcommentsのパラメータはそれぞれどういう意味ですか？
Doubanの作品リンクから、映画・書籍・アルバムに寄せられた短評を一覧表示します。各短評にはテキスト、評価ラベル、投稿者、投票数、日付が含まれます。これらの短評は、reviewsが返す長文レビューとは別のものです。
url必須- 対象のURLを指定します。reviewsまたはcommentsアクションではmovie.douban.com、book.douban.com、music.douban.com上の/subject/<ID>/形式、group_topicではwww.douban.com/group/topic/<ID>/形式です。長文レビュー、短評、グループトピックへの返信は、それぞれ別のアクションのエンドポイントで扱います。Douban Movies：長文レビュー、短評、表示範囲の制限 — Douban Moviesでは映画レビューと短評を分けて説明しており、短評欄にはすべての短評が表示されるわけではなく、折りたたまれたコンテンツは公開範囲が異なると注記しています。このエンドポイントが返す映画レビューの一覧を、完全な履歴や観客全体の意見と捉えないでください。また、この情報源は書籍や音楽に関する個別のルールに代わるものではありません。 · 確認日
Doubanのgroup_topicのパラメータはそれぞれどういう意味ですか？
Doubanグループのディスカッションをトピックリンクから読み取ります。最初の投稿、グループ名とリンク、投稿者、返信数、返信を取得できます。max_repliesで取得する返信数を1〜100の範囲で指定します（デフォルトは20）。非公開グループにはアクセスできず、スレッドが不完全な場合があります。
url必須- 対象のURLを指定します。reviewsまたはcommentsアクションではmovie.douban.com、book.douban.com、music.douban.com上の/subject/<ID>/形式、group_topicではwww.douban.com/group/topic/<ID>/形式です。長文レビュー、短評、グループトピックへの返信は、それぞれ別のアクションのエンドポイントで扱います。Doubanグループ：トピックの閲覧とメンバー管理は別の機能 — Doubanのヘルプでは、グループへの参加、トピックの固定、メンバー管理を別々の機能として挙げており、一部の操作にはグループのリーダーまたは管理者の権限が必要です。ここで特定のトピックを取得し、管理に関するドキュメントを引用しても、それらの権限が付与されるわけではありません。参加、投稿、管理の操作を提供するものでもありません。 · 確認日
max_replies任意- group_topicで1リクエストあたりに取得するトピック返信の件数上限を指定します。1〜100の整数を受け付けます（デフォルト20）。範囲外の値は上限値または下限値に補正され、数値として解釈できない値はデフォルトに戻ります。返される件数は、過去のすべての返信を取得できることを保証するものではありません。
Douban 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":"douban","action":"search","params":{"keyword":"<keyword>"}}'
Douban APIに関する質問
Douban APIでは何を取得できますか？
platformをdoubanに設定します。現在のカタログには検索、レビュー、コメント、グループのトピックが掲載されています。これらのアクション名はそれぞれ異なるDoubanのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Doubanのsearchリクエストを開始するには、どの入力を使用しますか？
Doubanの映画、書籍、音楽の作品を探すための、タイトルまたはトピックの検索キーワードを指定します。長文レビューやグループトピック内の全文検索は行いません。params内のkeywordとして送信してください。
Doubanのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、subject_type、year、directorが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Doubanのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。