エンドポイント

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

リクエストパラメータ

api_id必須
APIID

登録時に割り振られたID

値の例YOUR_API_ID
使用例api_id=YOUR_API_ID
affiliate_id必須
アフィリエイトID

APIリクエスト専用のアフィリエイトID(末尾990~999)。※商品リンク作成時は通常のアフィリエイトIDをご利用ください

値の例affiliate-990
使用例affiliate_id=affiliate-990
site必須
サイト

一般(DMM.com)かアダルト(FANZA)か

値の例FANZA
使用例site=FANZA
service任意
サービス

フロアAPIから取得できるサービスコードを指定

値の例digital
使用例service=digital
floor任意
フロア

フロアAPIから取得できるフロアコードを指定

値の例videoa
使用例floor=videoa
hits任意
取得件数

初期値:20 最大:100

値の例20
使用例hits=20
offset任意
検索開始位置

初期値:1 最大:50000

値の例1
使用例offset=1
sort任意
ソート順

初期値:rank
人気:rank
価格が高い順:price
価格が安い順:-price
発売日:date
評価:review
マッチング順:match

値の例rank
使用例sort=rank
keyword任意
キーワード

UTF-8で指定
キーワード検索のヒント

値の例松本いちか
使用例keyword=松本いちか
cid任意
商品ID

商品に振られているcontent_id

値の例mizd00320
使用例cid=mizd00320
article任意
絞りこみ項目

女優:actress
作者:author
ジャンル:genre
シリーズ:series
メーカー:maker
絞り込み項目を複数設定する場合、パラメータ名を配列化します。
例:&article[0]=genre&article[1]=actress

値の例actress
使用例article[0]=genre&article[1]=actress
article_id任意
絞り込みID

上記絞り込み項目のID(各検索APIから取得可能)
絞り込み項目を複数設定する場合、パラメータ名を配列化します。
例:&article_id[0]=111111&article_id[1]=222222

値の例1011199
使用例article_id[0]=111111&article_id[1]=222222
gte_date任意
発売日絞り込み

このパラメータで指定した日付以降に発売された商品を絞り込むことができます。
ISO8601形式でフォーマットした日付を指定してください。(ただし、タイムゾーンは指定できません)

値の例2016-04-01T00:00:00
使用例gte_date=2016-04-01T00:00:00
lte_date任意
発売日絞り込み

このパラメータで指定した日付以前に発売された商品を絞り込むことができます。
フォーマットはgte_dateと同じです。

値の例2016-04-30T23:59:59
使用例lte_date=2016-04-30T23:59:59
mono_stock任意
在庫絞り込み

初期値:絞り込みなし
在庫あり:stock
予約商品(在庫あり):reserve
予約商品(キャンセル待ち):reserve_empty
DMM通販のみ:mono
マーケットプレイスのみ:dmp
※通販サービスのみ指定可能

値の例mono
使用例mono_stock=mono
output任意
出力形式

json / xml

値の例json
使用例output=json
callback任意
コールバック

出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます

値の例callback
使用例callback=callback

全パラメータ例

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_306
476×306
http://www.dmm.co.jp/litevideo/...
size_560_360
560×360
http://www.dmm.co.jp/litevideo/...
size_644_414
644×414
http://www.dmm.co.jp/litevideo/...
size_720_480
720×480
http://www.dmm.co.jp/litevideo/...
pc_flag
PC対応しているか
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
アルバム、シングル
jancode
JANコード
4988135965905
maker_product
メーカー品番
10003-54653
isbn
ISBN
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
キャンペーンタイトル