エンドポイント
GET https://api.dmm.com/affiliate/v3/ItemList
リクエストURL例
https://api.dmm.com/affiliate/v3/ItemList?api_id=[APIID]&affiliate_id=[アフィリエイトID]&site=FANZA&service=digital&floor=videoa&hits=10&sort=date&keyword=%e4%b8%8a%e5%8e%9f%e4%ba%9c%e8%a1%a3&output=json
リクエストパラメータ
| 論理名 | 物理名 | 必須 | 値のサンプル | 使用例 | 概要 |
|---|---|---|---|---|---|
| APIID | api_id | 必須 | YOUR_API_ID | api_id=YOUR_API_ID | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | 必須 | affiliate-990 | affiliate_id=affiliate-990 | APIリクエスト専用のアフィリエイトID(末尾990~999)。※商品リンク作成時は通常のアフィリエイトIDをご利用ください |
| サイト | site | 必須 | FANZA | site=FANZA | 一般(DMM.com)かアダルト(FANZA)か |
| サービス | service | 任意 | digital | service=digital | フロアAPIから取得できるサービスコードを指定 |
| フロア | floor | 任意 | videoa | floor=videoa | フロアAPIから取得できるフロアコードを指定 |
| 取得件数 | hits | 任意 | 20 | hits=20 | 初期値:20 最大:100 |
| 検索開始位置 | offset | 任意 | 1 | offset=1 | 初期値:1 最大:50000 |
| ソート順 | sort | 任意 | rank | sort=rank | 初期値:rank 人気:rank 価格が高い順:price 価格が安い順:-price 発売日:date 評価:review マッチング順:match |
| キーワード | keyword | 任意 | 松本いちか | keyword=松本いちか | UTF-8で指定 キーワード検索のヒント |
| 商品ID | cid | 任意 | mizd00320 | cid=mizd00320 | 商品に振られているcontent_id |
| 絞りこみ項目 | article | 任意 | actress | article[0]=genre&article[1]=actress | 女優:actress 作者:author ジャンル:genre シリーズ:series メーカー:maker 絞り込み項目を複数設定する場合、パラメータ名を配列化します。 例:&article[0]=genre&article[1]=actress |
| 絞り込みID | article_id | 任意 | 1011199 | article_id[0]=111111&article_id[1]=222222 | 上記絞り込み項目のID(各検索APIから取得可能) 絞り込み項目を複数設定する場合、パラメータ名を配列化します。 例:&article_id[0]=111111&article_id[1]=222222 |
| 発売日絞り込み | gte_date | 任意 | 2016-04-01T00:00:00 | gte_date=2016-04-01T00:00:00 | このパラメータで指定した日付以降に発売された商品を絞り込むことができます。 ISO8601形式でフォーマットした日付を指定してください。(ただし、タイムゾーンは指定できません) |
| 発売日絞り込み | lte_date | 任意 | 2016-04-30T23:59:59 | lte_date=2016-04-30T23:59:59 | このパラメータで指定した日付以前に発売された商品を絞り込むことができます。 フォーマットはgte_dateと同じです。 |
| 在庫絞り込み | mono_stock | 任意 | mono | mono_stock=mono | 初期値:絞り込みなし 在庫あり:stock 予約商品(在庫あり):reserve 予約商品(キャンセル待ち):reserve_empty DMM通販のみ:mono マーケットプレイスのみ:dmp ※通販サービスのみ指定可能 |
| 出力形式 | output | 任意 | json | output=json | json / xml |
| コールバック | callback | 任意 | callback | callback=callback | 出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます |
全パラメータ例
https://api.dmm.com/affiliate/v3/ItemList?
api_id=YOUR_API_ID&
affiliate_id=affiliate-990&
site=FANZA&
service=digital&
floor=videoa&
hits=20&
offset=1&
sort=rank&
keyword=松本いちか&
cid=mizd00320&
article[0]=genre&
article[1]=actress&
article_id[0]=111111&
article_id[1]=222222&
gte_date=2016-04-01T00:00:00&
lte_date=2016-04-30T23:59:59&
mono_stock=mono&
output=json&
callback=callback
パラメータ値は読みやすさのために未エンコードで記載しています。送信時は URL エンコードしてください。
SDK での使用例
const dmm = require('dmm.js');
const client = new dmm.Client({
api_id: "YOUR_API_ID",
affiliate_id: "affiliate-990"
});
client.product(
{
site: "FANZA",
service: "digital",
floor: "videoa",
hits: 20,
offset: 1,
sort: "rank",
keyword: "松本いちか",
cid: "mizd00320",
article: ['genre', 'actress'],
article_id: [111111, 222222],
gte_date: "2016-04-01T00:00:00",
lte_date: "2016-04-30T23:59:59",
mono_stock: "mono",
output: "json",
callback: "callback",
},
(err, data) => {
if (err) {
console.error(err);
return;
}
console.log(data);
}
);
レスポンスフィールド
フィールド
説明
例
リクエストパラメータ
nameパラメータ名
site
value値
FANZA
statusステータスコード
200
result_count取得件数
20
total_count全体件数
50000
first_position検索開始位置
1
商品情報
service_codeサービスコード
digital
service_nameサービス名
動画
floor_codeフロアコード
videoa
floor_nameフロア名
ビデオ
category_nameカテゴリ名
ビデオ (動画)
content_id商品ID
15dss00145
product_id品番
15dss00145dl
titleタイトル
GET!! 素人ナンパ Best100!! 街角女子ベスト100人 8時間
volume収録時間 or ページ数
350
number巻数
3
レビュー平均点
countレビュー数
8
averageレビュー平均点
3.13
URL商品ページURL
http://video.dmm.co.jp/av/content/?id=15dss00145
affiliateURLアフィリエイトリンクURL
https://al.fanza.co.jp/...
画像URL
listリストページ用
http://pics.dmm.co.jp/.../15dss00145pt.jpg
small末端用(小)
http://pics.dmm.co.jp/.../15dss00145ps.jpg
large末端用(大)
http://pics.dmm.co.jp/.../15dss00145pl.jpg
URL立ち読みページURL
http://book.dmm.co.jp/tachiyomi/...
affilaiteURL立ち読みアフィリエイトリンクURL
https://al.fanza.co.jp/...
サンプル画像URL
サンプル(小)リスト
imageサンプル画像(小)
http://pics.dmm.co.jp/.../15dss00145-1.jpg
サンプル(大)リスト
imageサンプル画像(大)
http://pics.dmm.co.jp/.../15dss00145jp-1.jpg
サンプル動画URL
size_476_306476×306
http://www.dmm.co.jp/litevideo/...
size_560_360560×360
http://www.dmm.co.jp/litevideo/...
size_644_414644×414
http://www.dmm.co.jp/litevideo/...
size_720_480720×480
http://www.dmm.co.jp/litevideo/...
pc_flagPC対応しているか
1
sp_flagスマホ対応しているか
1
価格
price金額
300~
list_price定価
配信リスト
配信
type配信タイプ
stream
price配信価格
300
date発売日、配信開始日、貸出開始日
2012/8/3 10:00
商品詳細
ジャンル
nameジャンル名
ベスト・総集編
idジャンルID
6003
シリーズ
nameシリーズ名
GETシリーズ
idシリーズID
1006
メーカー
nameメーカー名
桃太郎映像出版
idメーカーID
40016
出演者(一般作品のみ)
name出演者名
id出演者ID
女優(アダルト作品のみ)
name女優名
小澤マリア
id女優ID
15187
監督
name監督名
id監督ID
作家、原作者、著者
name作家、原作者、著者名
id作家、原作者、著者ID
レーベル
nameレーベル名
LADY HUNTERS
idレーベルID
76
タイプ
nameタイプ名
idタイプID
カラー
nameカラー名
idカラーID
サイズ
nameサイズ名
idサイズID
CD情報
kindアルバム、シングル
jancodeJANコード
4988135965905
maker_productメーカー品番
10003-54653
isbnISBN
stock在庫状況
reserve
パンくずリスト
idパンくずID
783
nameパンくず名
J-POP等
キャンペーン情報
date_beginキャンペーン開始日時
2023-05-01 10:00:00
date_endキャンペーン終了日時
2023-05-31 23:59:59
titleキャンペーンタイトル