DMM Web APIでAI生成同人作品を検索する方法

前提条件

DMM API IDの発行手順

APIを使用するには、DMMへのアカウント登録とDMMアフィリエイトの登録が必要です。

詳細な手順については、下記の記事が参考になります。スクリーンショット付きで丁寧に解説されています。

DMMアフィリエイトの登録には運営しているサイトのURLが必要になるため、事前に用意しておきましょう。

DMM APIの基本的な使い方

API IDとアフィリエイトIDを取得できれば、DMMの様々な情報を取得できるようになります。

基本的な使い方については、下記の公式ドキュメントを参照してください。ただし、最低限の情報しか記載されていないため、以下で具体的な使用方法を解説します。

フロア検索

フロア検索は、パラメータが最小限のため、APIの使用を始めるのに適しています。

使用するURLは以下の通りです。

https://api.dmm.com/affiliate/v3/FloorList?api_id=[APIID]&affiliate_id=[アフィリエイトID]&output=json

[APIID]と[アフィリエイトID]には、取得したAPI IDとアフィリエイトIDを入力してください。前後の[ ]は不要です。

ブラウザでの実行

手軽に情報を取得するには、ブラウザのアドレスバーにこのURLを入力して検索します。

すると、以下のようにデータが画面に表示されます。ただし、この形式では内容が分かりにくいです。

このデータを表形式で整理したものが以下になります。フロアの情報を返してくれているわけです。この中のサービスコードやフロアコード、フロアIDは、他のAPIでもパラメータとして使用するので覚えておきましょう。

Pythonでの実行

このURLはPythonでも実行できます。以下のコードでAPI_IDとAFFILIATE_IDに実際のAPI IDとアフィリエイトIDを入力してください。

import requests
import json
# DMM API設定
API_ID = "XXXXXXXXXXX"
AFFILIATE_ID = "XXXXXXXXXXX"
# APIエンドポイント
url = "https://api.dmm.com/affiliate/v3/FloorList"
# パラメータ
params = {
    "api_id": API_ID,
    "affiliate_id": AFFILIATE_ID,
    "output": "json"
}
def test_dmm_api():
    """DMM APIの基本的なテスト"""
    try:
        # APIリクエスト実行
        response = requests.get(url, params=params)
        response.raise_for_status()
        
        # レスポンスをJSONで取得
        data = response.json()
        
        print("API呼び出し成功!")
        print(f"ステータスコード: {response.status_code}")
        print(f"レスポンス: {json.dumps(data, indent=2, ensure_ascii=False)}")
        
        return data
        
    except requests.exceptions.RequestException as e:
        print(f"API呼び出しエラー: {e}")
        return None
    except json.JSONDecodeError as e:
        print(f"JSON解析エラー: {e}")
        return None
if __name__ == "__main__":
    test_dmm_api()

このコードを実行すると、コンソールに出力結果が表示されます。

GitHubなどでコードを管理する場合は、API_IDやAFFILIATE_IDは環境変数で管理してください。Pythonではpython-dotenvライブラリを使用して.envファイルで管理することをお勧めします。

ジャンル検索

次にジャンル検索について説明します。ここでは先ほど取得したフロアのフロアIDを使用する必要があります。

例として「同人」のフロアID81を使用して、同人フロアのジャンルを検索してみましょう。

使用するURLは以下の通りです。

https://api.dmm.com/affiliate/v3/GenreSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&floor_id=81&output=json

同様にブラウザで検索するとデータが表示されます。

Pythonでのコードは以下のようになります。

# ジャンル検索のパラメータ例（同人フロアの場合）
params = {
    "api_id": API_ID,
    "affiliate_id": AFFILIATE_ID,
    "floor_id": "81",
    "output": "json"
}

floor_idパラメータが追加されているのが分かります。

実行すると同人で使用されているジャンルデータを返してくれます。

AI生成同人作品の検索方法

ここまでの情報を基に、AI生成作品に絞って同人作品を検索する方法を説明します。

使用するのは商品情報を取得するAPIです。

実際の検索用Pythonコードは以下の通りです。

import requests
import json
# DMM API設定
API_ID = "XXXXXXXXXXX"
AFFILIATE_ID = "XXXXXXXXXXX"
# APIエンドポイント
url = "https://api.dmm.com/affiliate/v3/ItemList"
# パラメータ
params = {
    "api_id": API_ID,
    "affiliate_id": AFFILIATE_ID,
    "site": "FANZA",
    "service": "doujin",
    "floor": "digital_doujin",
    "article": "ai",
    "article_id": "2",
    "output": "json"
}

serviceとfloorパラメータは、先ほど取得したフロア情報を基に入力しています。商品検索ではフロアIDではなくフロアコードを使用することに注意してください。

AIに関するarticleとarticle_idパラメータについては、公式のAPIドキュメントには記載されていません。

これらの値は、AIフロアのURLから推測できます。

AIフロアのURLは以下のようになっています。

https://www.dmm.co.jp/dc/doujin/-/list/=/article=ai/id=2/section=mens

このURLのarticle=aiとid=2が、APIパラメータとして使用されています。

商品検索のリクエストパラメータを確認してみましょう。

articleとarticle_idパラメータが存在していることが分かります。これらのパラメータを組み合わせることで、AI生成同人作品のみを取得できます。

URLを確認すると、AIで生成された同人作品のページが表示されていることが分かります。

まとめ

AI作品に絞ることで、WordPressなどを使ってアフィリエイトサイトを運営する際に、AI特化サイトとして運用できます。

AI作品は手軽に制作できるため大量に出品されており、アフィリエイト対象作品には困りません。ただし、質の低い作品も含まれているため、適切な選別を行う運用も必要です。