DMMアフィリエイト API ドキュメント

エンドポイント

GET https://api.dmm.com/affiliate/v3/ActressSearch

リクエストURL例

https://api.dmm.com/affiliate/v3/ActressSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&keyword=%e3%81%82%e3%81%95%e3%81%bf&gte_bust=90&lte_waist=60&sort=-bust&hits=10&offset=10&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

initial任意

頭文字(50音)

50音をUTF-8で指定

値の例あ

使用例initial=あ

actress_id任意

女優ID

値の例15365

使用例actress_id=15365

keyword任意

キーワード

UTF-8で指定

値の例あさみ

使用例keyword=あさみ

gte_bust任意

バスト

gte_bust=90ならバスト90cm以上、
lte_bust=90ならバスト90cm以下
gte_bust=90&lte_bust=100なら
バスト90cm以上～100cm以下

値の例90

使用例gte_bust=90

lte_bust任意

バスト

gte_bust=90ならバスト90cm以上、
lte_bust=90ならバスト90cm以下
gte_bust=90&lte_bust=100なら
バスト90cm以上～100cm以下

値の例90

使用例lte_bust=90

gte_waist任意

ウエスト

同上

値の例60

使用例gte_waist=60

lte_waist任意

ウエスト

同上

値の例60

使用例lte_waist=60

gte_hip任意

ヒップ

同上

値の例90

使用例gte_hip=90

lte_hip任意

ヒップ

同上

値の例90

使用例lte_hip=90

gte_height任意

身長

同上

値の例160

使用例gte_height=160

lte_height任意

身長

同上

値の例160

使用例lte_height=160

gte_birshday任意

生年月日

yyyymmddの形式で指定
gte_birthday=1990-01-01なら1990年1月1日以降生まれ
lte_birthday=1990-01-01なら1990年1月1日以前生まれ
gte_birthday=1980-01-01&lte_birthday=1989-12-31なら
1980年1月1日生まれ～1989年12月31日生まれ

値の例1990-01-01

使用例gte_birshday=1990-01-01

lte_birthday任意

生年月日

値の例1990-01-01

使用例lte_birthday=1990-01-01

hits任意

取得件数

初期値：20 最大：100

値の例20

使用例hits=20

offset任意

検索開始位置

初期値：1

値の例1

使用例offset=1

sort任意

ソート順

名前昇順：name
名前降順：-name
バスト昇順：bust
バスト降順：-bust
ウエスト昇順：waist
ウエスト降順：-waist
ヒップ昇順：hip
ヒップ降順：-hip
身長昇順：height
身長降順：-height
生年月日昇順：birthday
生年月日降順：-birthday
女優ID昇順：id
女優ID降順：-id

値の例-name

使用例sort=-name

output任意

出力形式

json / xml

値の例json

使用例output=json

callback任意

コールバック

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

値の例callback

使用例callback=callback

全パラメータ例

https://api.dmm.com/affiliate/v3/ActressSearch?
  api_id=YOUR_API_ID&
  affiliate_id=affiliate-990&
  initial=あ&
  actress_id=15365&
  keyword=あさみ&
  gte_bust=90&
  lte_bust=90&
  gte_waist=60&
  lte_waist=60&
  gte_hip=90&
  lte_hip=90&
  gte_height=160&
  lte_height=160&
  gte_birshday=1990-01-01&
  lte_birthday=1990-01-01&
  hits=20&
  offset=1&
  sort=-name&
  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.actress(
  {
    initial: "あ",
    actress_id: 15365,
    keyword: "あさみ",
    gte_bust: "90",
    lte_bust: "90",
    gte_waist: "60",
    lte_waist: "60",
    gte_hip: "90",
    lte_hip: "90",
    gte_height: "160",
    lte_height: "160",
    gte_birshday: "1990-01-01",
    lte_birthday: "1990-01-01",
    hits: 20,
    offset: 1,
    sort: "-name",
    output: "json",
    callback: "callback",
  },
  (err, data) => {
    if (err) {
      console.error(err);
      return;
    }
    console.log(data);
  }
);

レスポンスフィールド

フィールド

説明

例

リクエストパラメータ

name

パラメータ名

keyword

value

値

あさみ

status

ステータスコード

200

result_count

取得件数

total_count

全体件数

64964

first_position

検索開始位置

女優情報

id

女優ID

15365

name

女優名

麻美ゆま

ruby

女優名（読み仮名）

あさみゆま

bust

バスト

cup

カップ数

waist

ウェスト

hip

ヒップ

height

身長

158

birthday

生年月日

1987-03-24

blood_type

血液型

hobby

趣味

香水集め、英会話、ピアノ

prefectures

出身地

東京都

画像URL

small

画像（小）

http://pics.dmm.co.jp/mono/actjpgs/thumbnail/asami_yuma.jpg

large

画像（大）

http://pics.dmm.co.jp/mono/actjpgs/asami_yuma.jpg

リストページURL(アフィリエイトID付き)

digital

動画

https://al.fanza.co.jp/...

monthly

月額動画見放題chデラックス

https://al.fanza.co.jp/...

mono

DVD通販

https://al.fanza.co.jp/...