dmm-search3 1.2

DMM Web API v3.0 for Python3

dmm_search3

https://pypi.org/project/dmm-search3/

dmm_search3 is 何

DMM WebサービスをPythonで扱うためのライブラリです。コチラからアカウントを作成して、API IDとアフィリエイトIDを取得しておく必要があります。

インストール

pipでインストールします。

$ pip3 install dmm_search3

使い方

モジュールのインポート

from dmm import DMM

取得したAPI IDとアフィリエイトIDをセット

api_id = 'your_api_id'
affiliate_id = 'your_affiliate_id'

インスタンスの作成

dmm = DMM(api_id=api_id, affiliate_id=affiliate_id)

検索(search)メソッド

dmm.search('ItemList', keyword='バレンタイン', hits=5, offset=10, sort='review')

検索メソッドの第一引数は、ItemList(商品検索)、FloorList(フロア検索)、ActressSearch(女優検索)、GenreSearch(ジャンル検索)、MakerSearch(メーカー検索)、SeriesSearch(シリーズ検索)、AuthorSearch(作者検索)のいずれかを指定します。第二引数以降はAPIリファレンスのリクエストパラメータを指定します。可変長引数で受け取るので、keyword='バレンタイン'のように明示的にキーワードと値を指定します。必須パラメーターであるapi_id、affiliate_idはインスタンス作成時、siteはデフォルトで'FANZA'に設定してあります。

メソッドの使用例

items = dmm.search('ItemList', keyword='バレンタイン', hits=9)
for i in items['items']:
    print(i.get('title'))

# => バレンタイン・ゲーム（単話）   
#    落合くんの半減（単話）
#    オトメ錬金術（単話）
#    アクションピザッツ 2016年4月号
#    コミックホットミルク 2016年03月号
#    comicアンスリウム Vol.35
#    すぺしゃるでこれーしょん（単話）
#    とっぴんぐえんじぇるず（単話）
#    チョコはおまけで（単話）

レスポンスに関してもAPIリファレンスのレスポンスフィールドを参照してください。

searchメソッド引数

第一引数

論理名	物理名	APIリファレンス
商品検索	ItemList	https://affiliate.dmm.com/api/v3/itemlist.html
フロア検索	FloorList	https://affiliate.dmm.com/api/v3/floorlist.html
女優検索	ActressSearch	https://affiliate.dmm.com/api/v3/actresssearch.html
ジャンル検索	GenreSearch	https://affiliate.dmm.com/api/v3/genresearch.html
メーカー検索	MakerSearch	https://affiliate.dmm.com/api/v3/makersearch.html
シリーズ検索	SeriesSearch	https://affiliate.dmm.com/api/v3/seriessearch.html
作者検索	AuthorSearch	https://affiliate.dmm.com/api/v3/authorsearch.html

第二引数以降(商品検索のリクエストパラメーター引用)

論理名	物理名	必須	値のサンプル	概要
APIID	api_id	○		登録時に割り振られたID
アフィリエイトID	affiliate_id	○	affiliate-990	登録時に割り振られた990
サイト	site	○	FANZA	一般（DMM.com）かアダルト（FANZA）か
サービス	service		digital	フロアAPIから取得できるサービスコードを指定
フロア	floor		videoa	フロアAPIから取得できるフロアコードを指定
取得件数	hits		20	初期値：20 最大：100
検索開始位置	offset		1	初期値：1 最大：50000
ソート順	sort		rank	初期値：rank 人気：rank 価格が高い：pric 価格が安い順：-price 新着：date 評価：review
キーワード	keyword		上原亜衣	UTF-8で指定
商品ID	cid		15dss00145	商品に振られているcontent_id
絞りこみ項目	article		actress	女優：actress 作者：author ジャンル：genre シリーズ：series メーカー：maker
絞り込みID	article_id		1011199	上記絞り込み項目のID(各検索APIから取得可能)
発売日絞り込み	gte_date		2016-04-01T00:00:00	このパラメータで指定した日付以降に発売された商品を絞り込むことができます。ISO8601形式でフォーマットした日付を指定してください。(ただし、タイムゾーンは指定できません)
在庫絞り込み	mono_stock		mono	初期値：絞り込みなし 在庫あり：stock 予約受付中：reserve DMM通販のみ：mono マーケットプレイスのみ：dmp ※通販サービスのみ指定可能
出力形式	output		json	json / xml
コールバック	callback		callback	出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます

サンプル動画ダウンロード(sample_download)メソッド

DMM.sample_download(cid='1vandr00069', fname='sample')

サンプル動画ダウンロードメソッドはクラスメソッドなので、インスタンス化する必要はありません。第一引数に動画のcontent_idを、第二引数にはファイル名を入れます。第二引数を入れた場合は、sample.mp4というファイル名でダウンロードされます。省略した場合はcontent_idがそのままファイル名(1vandr00069.mp4)となります。

メソッドの使用例

searchメソッドからcontent_idを抜き出して、sample_downloadメソッドに渡す

items = dmm.search('ItemList', keyword='バレンタイン', hits=9)
for i in items['items']:
    cid = i.get('cid')
    DMM.sample_download(cid)

License

MIT
https://github.com/0x0u/dmm_search3/blob/master/LICENSE.txt