PR

DUGA の Web サービス(API)の使い方|必要なID・制限・クレジット表示

DUGA の作品情報を自分のサイトに取り込みたいときに使うのが、DUGA の Web サービス(API)です。この記事では、API でできること、必要なID、使うときの制限とクレジット表示を、DUGA の公式の案内にもとづいて整理します。

※ DUGA の画面や規約は変わることがあります。使う前に、DUGA の公式ページで最新の案内を確認してください。

この記事でわかること

  • DUGA の Web サービス(API)でできること
  • 必要なID(代理店ID・アプリケーションID・バナーID)
  • リクエストの制限と、使うときの注意
  • クレジット表示の義務

スポンサードサーチ

DUGA の Web サービス(API)でできること

DUGA の作品データベースを、外部のサイトやアプリから使うための仕組みです(公式ページ:duga.jp/aff/api.html)。キーワード検索のほか、レーベル・カテゴリ・販売種別での絞り込みができます。結果の形式は、XML または JSON から選べます。

必要なID

  • 代理店ID:DUGA アフィリエイトの登録で発行されます。取り方はDUGAアフィリエイトの始め方で説明しています。
  • アプリケーションID:Web サービスを使うために必要なIDです。代理店IDごとに発行され、1つの代理店IDで最大5個です。発行の手順は、公式のページに詳しい記載がありませんでした。解説の多くは、ログイン後のウェブサービスの画面から申請すると説明しています(公式では未確認です)。
  • バナーID:クレジット表示のリンクなどに使うIDです。アフィリエイトの管理画面で確認できると説明する解説が多いですが、公式のウェブサービスのページには記載がありませんでした(公式では未確認です)。

プラグインの入力欄との対応:DUGA API Content Engine の「API設定」にある「API ID」にはアプリケーションID、「アフィリエイトID」には代理店IDを入れます(バナーIDはそのままバナーIDです)。名前が似ていて取り違えやすいので、ご注意ください。

1人または1社で複数の代理店IDを取得することは禁止されています。アプリケーションIDを増やしたいときも、代理店IDは1つのままにしてください。

スポンサードサーチ

リクエストの制限と、使い方の注意

  • 回数の上限:1つのアプリケーションIDにつき、60秒間に60回までです。上限を超えると、API からエラーが返ります。
  • キャッシュの推奨:公式の案内では、ユーザーが操作するたびに API を呼ぶのではなく、あらかじめ取得したデータから作ったキャッシュを返す方法が推奨されています。
  • サポート:DUGA は、開発の技術サポートや、CMS のプラグインの導入・連携・設定のサポートを行っていません。自分で調べて進めるか、使う道具の提供元に確認します。

クレジット表示の義務

API とレスポンスの情報を使うすべてのサイトやアプリには、所定のクレジットを表示する義務があります。表示例の画像は、公式のウェブサービスのページに載っています。具体的な表記・大きさ・配置の決まりは、そのページには書かれていませんでした。表示のしかたは、公式の案内でご自身で確認してください。

スポンサードサーチ

よくある失敗

  • アプリケーションIDを人に見せてしまう(記事・画像・ソースコード・SNS に出さない)。
  • 短い間隔で何度も API を呼び、上限(60秒間に60回)を超えてエラーになる。
  • クレジット表示を付け忘れる。

IDがそろったら:記事づくりを自動化する

IDがそろえば、作品情報を WordPress の記事にする作業を自動化できます。WordPress プラグイン「DUGA API Content Engine(DUGA版)」は、API ID・アフィリエイトID・バナーIDを「API設定」に保存して「自動取り込み」をオンにすると、取り込みと記事づくりを自動で行います。クレジットの表示も、設定したIDで自動で出します(オン・オフを選べます。表示が DUGA の規定に合っているかは、ご自身で確認してください)。買い切り 5,100円(2026年11月時点)。最新の内容と価格は販売ページでご確認ください。

DUGA版の販売ページを見る(note)

FANZA の作品も扱う場合は、FANZA版との2本セット(8,980円)もあります。セットの販売ページ(note)

※ 収益や検索順位をお約束するものではありません。