エンドポイント
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>e_bust=90<e_waist=60&sort=-bust&hits=10&offset=10&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をご利用ください |
| 頭文字(50音) | initial | 任意 | あ | initial=あ | 50音をUTF-8で指定 |
| 女優ID | actress_id | 任意 | 15365 | actress_id=15365 | 女優ID |
| キーワード | keyword | 任意 | あさみ | keyword=あさみ | UTF-8で指定 |
| バスト | gte_bust | 任意 | 90 | gte_bust=90 | gte_bust=90ならバスト90cm以上、 lte_bust=90ならバスト90cm以下 gte_bust=90<e_bust=100なら バスト90cm以上~100cm以下 |
| バスト | lte_bust | 任意 | 90 | lte_bust=90 | gte_bust=90ならバスト90cm以上、 lte_bust=90ならバスト90cm以下 gte_bust=90<e_bust=100なら バスト90cm以上~100cm以下 |
| ウエスト | 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 | 任意 | 1990-01-01 | gte_birshday=1990-01-01 | yyyymmddの形式で指定 gte_birthday=1990-01-01なら1990年1月1日以降生まれ lte_birthday=1990-01-01なら1990年1月1日以前生まれ gte_birthday=1980-01-01<e_birthday=1989-12-31なら 1980年1月1日生まれ~1989年12月31日生まれ |
| 生年月日 | lte_birthday | 任意 | 1990-01-01 | lte_birthday=1990-01-01 | yyyymmddの形式で指定 gte_birthday=1990-01-01なら1990年1月1日以降生まれ lte_birthday=1990-01-01なら1990年1月1日以前生まれ gte_birthday=1980-01-01<e_birthday=1989-12-31なら 1980年1月1日生まれ~1989年12月31日生まれ |
| 取得件数 | hits | 任意 | 20 | hits=20 | 初期値:20 最大:100 |
| 検索開始位置 | offset | 任意 | 1 | offset=1 | 初期値:1 |
| ソート順 | sort | 任意 | -name | sort=-name | 名前昇順:name 名前降順:-name バスト昇順:bust バスト降順:-bust ウエスト昇順:waist ウエスト降順:-waist ヒップ昇順:hip ヒップ降順:-hip 身長昇順:height 身長降順:-height 生年月日昇順:birthday 生年月日降順:-birthday 女優ID昇順:id 女優ID降順:-id |
| 出力形式 | output | 任意 | json | output=json | json / xml |
| コールバック | callback | 任意 | callback | callback=callback | 出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます |
全パラメータ例
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取得件数
20
total_count全体件数
64964
first_position検索開始位置
1
女優情報
id女優ID
15365
name女優名
麻美ゆま
ruby女優名(読み仮名)
あさみゆま
bustバスト
96
cupカップ数
H
waistウェスト
58
hipヒップ
88
height身長
158
birthday生年月日
1987-03-24
blood_type血液型
AB
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/...
monoDVD通販
https://al.fanza.co.jp/...