エンドポイント
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必須登録時に割り振られたID
api_id=YOUR_API_IDaffiliate_id必須APIリクエスト専用のアフィリエイトID(末尾990~999)。※商品リンク作成時は通常のアフィリエイトIDをご利用ください
affiliate_id=affiliate-990site必須一般(DMM.com)かアダルト(FANZA)か
site=FANZAservice任意フロアAPIから取得できるサービスコードを指定
service=digitalfloor任意フロアAPIから取得できるフロアコードを指定
floor=videoahits任意初期値:20 最大:100
hits=20offset任意初期値:1 最大:50000
offset=1sort任意初期値:rank
人気:rank
価格が高い順:price
価格が安い順:-price
発売日:date
評価:review
マッチング順:match
sort=rankkeyword任意UTF-8で指定
キーワード検索のヒント
keyword=松本いちかcid任意商品に振られているcontent_id
cid=mizd00320article任意女優:actress
作者:author
ジャンル:genre
シリーズ:series
メーカー:maker
絞り込み項目を複数設定する場合、パラメータ名を配列化します。
例:&article[0]=genre&article[1]=actress
article[0]=genre&article[1]=actressarticle_id任意上記絞り込み項目のID(各検索APIから取得可能)
絞り込み項目を複数設定する場合、パラメータ名を配列化します。
例:&article_id[0]=111111&article_id[1]=222222
article_id[0]=111111&article_id[1]=222222gte_date任意このパラメータで指定した日付以降に発売された商品を絞り込むことができます。
ISO8601形式でフォーマットした日付を指定してください。(ただし、タイムゾーンは指定できません)
gte_date=2016-04-01T00:00:00lte_date任意このパラメータで指定した日付以前に発売された商品を絞り込むことができます。
フォーマットはgte_dateと同じです。
lte_date=2016-04-30T23:59:59mono_stock任意初期値:絞り込みなし
在庫あり:stock
予約商品(在庫あり):reserve
予約商品(キャンセル待ち):reserve_empty
DMM通販のみ:mono
マーケットプレイスのみ:dmp
※通販サービスのみ指定可能
mono_stock=monooutput任意json / xml
output=jsoncallback任意出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます
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);
}
);
レスポンスフィールド
namevaluestatusresult_counttotal_countfirst_positionservice_codeservice_namefloor_codefloor_namecategory_namecontent_idproduct_idtitlevolumenumbercountaverageURLaffiliateURLlistsmalllargeURLaffilaiteURLimageimagesize_476_306size_560_360size_644_414size_720_480pc_flagsp_flagpricelist_pricetypepricedatenameidnameidnameidnameidnameidnameidnameidnameidnameidnameidnameidkindjancodemaker_productisbnstockidnamedate_begindate_endtitle