DMM Web APIの仕様書

## 商品情報API

### エンドポイント

```
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・アフィリエイトIDを指定する際は前後の [ ] を除いて入力してください。

### クエリパラメータ

| 論理名 | 物理名 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| APIID | api_id | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| サイト | site | ○ | FANZA | 一般（DMM.com）またはアダルト（FANZA） |
| サービス | service |  | digital | フロアAPIから取得できるサービスコードを指定 |
| フロア | floor |  | videoa | フロアAPIから取得できるフロアコードを指定 |
| 取得件数 | hits |  | 20 | 初期値: 20、最大: 100 |
| 検索開始位置 | offset |  | 1 | 初期値: 1、最大: 50000 |
| ソート順 | sort |  | date | 利用可能値: rank / price / -price / date / review / match |
| キーワード | keyword |  | 松本いちか | UTF-8で指定 |
| 商品ID | cid |  | mizd00320 | 商品に振られている content_id |
| 絞り込み項目 | article |  | actress | 絞り込み項目（複数可: `article[0]=genre&article[1]=actress`）。値: actress / author / genre / series / maker |
| 絞り込みID | article_id |  | 1011199 | 絞り込み項目のID（複数可: `article_id[0]=111111&article_id[1]=222222`） |
| 発売日絞り込み(以降) | gte_date |  | 2016-04-01T00:00:00 | ISO8601形式（タイムゾーン指定不可） |
| 発売日絞り込み(以前) | lte_date |  | 2016-04-30T23:59:59 | ISO8601形式（タイムゾーン指定不可） |
| 在庫絞り込み | mono_stock |  | mono | 初期値: 絞り込みなし。利用可能値: stock / reserve / reserve_empty / mono / dmp（通販サービスのみ） |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | site |
| request.parameters[].value | リクエストパラメータ値 | FANZA |
| result.status | ステータスコード | 200 |
| result.result_count | 取得件数 | 20 |
| result.total_count | 全体件数 | 50000 |
| result.first_position | 検索開始位置 | 1 |
| result.items[] | 商品情報の配列 |  |
| result.items[].service_code | サービスコード | digital |
| result.items[].service_name | サービス名 | 動画 |
| result.items[].floor_code | フロアコード | videoa |
| result.items[].floor_name | フロア名 | ビデオ |
| result.items[].category_name | カテゴリ名 | ビデオ (動画) |
| result.items[].content_id | 商品ID | 15dss00145 |
| result.items[].product_id | 品番 | 15dss00145dl |
| result.items[].title | タイトル | GET！！ 素人ナンパ Best100！！ 街角女子ベスト100人 8時間 |
| result.items[].volume | 収録時間 or ページ数 | 350 |
| result.items[].number | 巻数 | 3 |
| result.items[].review.count | レビュー数 | 8 |
| result.items[].review.average | レビュー平均点 | 3.13 |
| result.items[].URL | 商品ページURL | http://video... |
| result.items[].affiliateURL | アフィリエイトリンクURL | https://al.dmm.co.jp/... |
| result.items[].imageURL.list | 画像URL（リスト） | http://pics.dmm.co.jp/...pt.jpg |
| result.items[].imageURL.small | 画像URL（小） | http://pics.dmm.co.jp/...ps.jpg |
| result.items[].imageURL.large | 画像URL（大） | http://pics.dmm.co.jp/...pl.jpg |
| result.items[].tachiyomi.URL | 立ち読みページURL | http://book.dmm.co.jp/tachiyomi/... |
| result.items[].tachiyomi.affiliateURL | 立ち読みアフィリエイトリンクURL | https://al.dmm.co.jp/... |
| result.items[].sampleImageURL.sample_s[].image | サンプル画像（小） | http://pics.dmm.co.jp/...-1.jpg |
| result.items[].sampleImageURL.sample_l[].image | サンプル画像（大） | http://pics.dmm.co.jp/...jp-1.jpg |
| result.items[].sampleMovieURL.size_* | サンプル動画URL（複数サイズ） | http://www.dmm.co.jp/litevideo/... |
| result.items[].sampleMovieURL.pc_flag | PC対応 | 1 |
| result.items[].sampleMovieURL.sp_flag | スマホ対応 | 1 |
| result.items[].prices.price | 金額 | 300～ |
| result.items[].prices.list_price | 定価 |  |
| result.items[].prices.deliveries[].delivery.type | 配信タイプ | stream |
| result.items[].prices.deliveries[].delivery.price | 配信価格 | 300 |
| result.items[].date | 発売/配信/貸出開始日 | 2012/8/3 10:00 |
| result.items[].iteminfo.genre.name | ジャンル名 | ベスト・総集編 |
| result.items[].iteminfo.genre.id | ジャンルID | 6003 |
| result.items[].iteminfo.series.name | シリーズ名 | GETシリーズ |
| result.items[].iteminfo.series.id | シリーズID | 1006 |
| result.items[].iteminfo.maker.name | メーカー名 | 桃太郎映像出版 |
| result.items[].iteminfo.maker.id | メーカーID | 40016 |
| result.items[].iteminfo.actor.name | 出演者名（一般） |  |
| result.items[].iteminfo.actor.id | 出演者ID（一般） |  |
| result.items[].iteminfo.actress.name | 女優名（アダルト） | 小澤マリア |
| result.items[].iteminfo.actress.id | 女優ID（アダルト） | 15187 |
| result.items[].iteminfo.director.name | 監督名 |  |
| result.items[].iteminfo.director.id | 監督ID |  |
| result.items[].iteminfo.author.name | 作家/原作者/著者名 |  |
| result.items[].iteminfo.author.id | 作家/原作者/著者ID |  |
| result.items[].iteminfo.label.name | レーベル名 | LADY HUNTERS |
| result.items[].iteminfo.label.id | レーベルID | 76 |
| result.items[].iteminfo.type.name | タイプ名 |  |
| result.items[].iteminfo.type.id | タイプID |  |
| result.items[].iteminfo.color.name | カラー名 |  |
| result.items[].iteminfo.color.id | カラーID |  |
| result.items[].iteminfo.size.name | サイズ名 |  |
| result.items[].iteminfo.size.id | サイズID |  |
| result.items[].cdinfo.kind | CD情報（アルバム/シングル） |  |
| result.items[].jancode | JANコード | 4988135965905 |
| result.items[].maker_product | メーカー品番 | 10003-54653 |
| result.items[].isbn | ISBN |  |
| result.items[].stock | 在庫状況 | reserve |
| result.items[].directory.id | パンくずID | 783 |
| result.items[].directory.name | パンくず名 | J-POP等 |
| result.items[].campaign.date_begin | キャンペーン開始日時 | 2023-05-01 10:00:00 |
| result.items[].campaign.date_end | キャンペーン終了日時 | 2023-05-31 23:59:59 |
| result.items[].campaign.title | キャンペーンタイトル |  |

## フロアAPI

### エンドポイント

```
https://api.dmm.com/affiliate/v3/FloorList?api_id=[APIID]&affiliate_id=[アフィリエイトID]&output=json&callback=example
```
※ APIID・アフィリエイトIDを指定する際は前後の [ ] を除いて入力してください。

### クエリパラメータ

| 論理名 | 物理名 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| APIID | api_id | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | affiliate_id |
| request.parameters[].value | リクエストパラメータ値 | affiliate-990 |
| result.site.name | サイト名 | DMM.com（一般） |
| result.site.code | サイトコード | DMM.com |
| result.site.service.name | サービス名 | 動画 |
| result.site.service.code | サービスコード | digital |
| result.site.service.floor.id | フロアID | 6 |
| result.site.service.floor.name | フロア名 | 映画・ドラマ |
| result.site.service.floor.code | フロアコード | cinema |

## 女優検索API

### エンドポイント

```
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 | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| フロアID | floor_id | ○ |  | フロア検索APIから取得可能なフロアID |
| 頭文字(50音) | initial |  | あ | 50音をUTF-8で指定 |
| 取得件数 | hits |  | 100 | 初期値: 100、最大: 500 |
| 検索開始位置 | offset |  | 1 | 初期値: 1 |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | affiliate_id |
| request.parameters[].value | リクエストパラメータ値 | affiliate-990 |
| result.status | ステータスコード | 200 |
| result.result_count | 取得件数 | 100 |
| result.total_count | 全体件数 | 1000 |
| result.first_position | 検索開始位置 | 1 |
| result.site_name | サイト名 | FANZA（アダルト） |
| result.site_code | サイトコード | FANZA |
| result.service_name | サービス名 | 動画 |
| result.service_code | サービスコード | digital |
| result.floor_id | フロアID | 40 |
| result.floor_name | フロア名 | ビデオ |
| result.floor_code | フロアコード | videoa |
| result.genre.genre_id | ジャンルID | 2001 |
| result.genre.name | ジャンル名 | 巨乳 |
| result.genre.ruby | ジャンル名(読み仮名) | きょにゅう |
| result.genre.list_url | リストページURL（アフィリエイトID付き） | https://al.dmm.co.jp/... |

## ジャンル検索API

### エンドポイント

```
https://api.dmm.com/affiliate/v3/GenreSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&initial=%e3%81%8d&floor_id=25&hits=10&offset=10&output=json
```

### クエリパラメータ

| 論理名 | 物理名 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| APIID | api_id | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| フロアID | floor_id | ○ |  | フロア検索APIから取得可能なフロアID |
| 頭文字(50音) | initial |  | あ | 50音をUTF-8で指定 |
| 取得件数 | hits |  | 100 | 初期値: 100、最大: 500 |
| 検索開始位置 | offset |  | 1 | 初期値: 1 |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | affiliate_id |
| request.parameters[].value | リクエストパラメータ値 | affiliate-990 |
| result.status | ステータスコード | 200 |
| result.result_count | 取得件数 | 100 |
| result.total_count | 全体件数 | 1000 |
| result.first_position | 検索開始位置 | 1 |
| result.site_name | サイト名 | FANZA（アダルト） |
| result.site_code | サイトコード | FANZA |
| result.service_name | サービス名 | 動画 |
| result.service_code | サービスコード | digital |
| result.floor_id | フロアID | 40 |
| result.floor_name | フロア名 | ビデオ |
| result.floor_code | フロアコード | videoa |
| result.genre.genre_id | ジャンルID | 2001 |
| result.genre.name | ジャンル名 | 巨乳 |
| result.genre.ruby | ジャンル名(読み仮名) | きょにゅう |
| result.genre.list_url | リストページURL（アフィリエイトID付き） | https://al.dmm.co.jp/... |

## メーカー検索API

### エンドポイント

```
https://api.dmm.com/affiliate/v3/MakerSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&floor_id=43&hits=10&offset=100&output=json
```

### クエリパラメータ

| 論理名 | 物理名 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| APIID | api_id | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| フロアID | floor_id | ○ |  | フロア検索APIから取得可能なフロアID |
| 頭文字(50音) | initial |  | あ | 50音をUTF-8で指定 |
| 取得件数 | hits |  | 100 | 初期値: 100、最大: 500 |
| 検索開始位置 | offset |  | 1 | 初期値: 1 |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | affiliate_id |
| request.parameters[].value | リクエストパラメータ値 | affiliate-990 |
| result.status | ステータスコード | 200 |
| result.result_count | 取得件数 | 100 |
| result.total_count | 全体件数 | 1000 |
| result.first_position | 検索開始位置 | 1 |
| result.site_name | サイト名 | FANZA（アダルト） |
| result.site_code | サイトコード | FANZA |
| result.service_name | サービス名 | 動画 |
| result.service_code | サービスコード | digital |
| result.floor_id | フロアID | 40 |
| result.floor_name | フロア名 | ビデオ |
| result.floor_code | フロアコード | videoa |
| result.maker.maker_id | メーカーID | 1509 |
| result.maker.name | メーカー名 | ムーディーズ |
| result.maker.ruby | メーカー名(読み仮名) | むーでぃーず |
| result.maker.list_url | リストページURL（アフィリエイトID付き） | https://al.dmm.co.jp/... |

## シリーズ検索API

### エンドポイント

```
https://api.dmm.com/affiliate/v3/SeriesSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&initial=%e3%81%8a&floor_id=27&hits=10&output=json
```

### クエリパラメータ

| 論理名 | 物理名 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| APIID | api_id | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| フロアID | floor_id | ○ |  | フロア検索APIから取得可能なフロアID |
| 頭文字(50音) | initial |  | あ | 50音をUTF-8で指定 |
| 取得件数 | hits |  | 100 | 初期値: 100、最大: 500 |
| 検索開始位置 | offset |  | 1 | 初期値: 1 |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | affiliate_id |
| request.parameters[].value | リクエストパラメータ値 | affiliate-990 |
| result.status | ステータスコード | 200 |
| result.result_count | 取得件数 | 100 |
| result.total_count | 全体件数 | 1000 |
| result.first_position | 検索開始位置 | 1 |
| result.site_name | サイト名 | DMM.com（一般） |
| result.site_code | サイトコード | DMM.com |
| result.service_name | サービス名 | 通販 |
| result.service_code | サービスコード | mono |
| result.floor_id | フロアID | 24 |
| result.floor_name | フロア名 | 本・コミック |
| result.floor_code | フロアコード | book |
| result.series.series_id | シリーズID | 62226 |
| result.series.name | シリーズ名 | ARIA |
| result.series.ruby | シリーズ名(読み仮名) | ありあ |
| result.series.list_url | リストページURL（アフィリエイトID付き） | https://al.dmm.co.jp/... |

## 作者検索API

### エンドポイント

```
https://api.dmm.com/affiliate/v3/AuthorSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&initial=%e3%81%86&floor_id=27&hits=10&output=json
```

### クエリパラメータ

| 論理名 | 物理名 | 必須 | 例 | 説明 |
|---|---|---|---|---|
| APIID | api_id | ○ |  | 登録時に割り振られたID |
| アフィリエイトID | affiliate_id | ○ | affiliate-990 | 登録時に割り振られた990～999までのアフィリエイトID |
| フロアID | floor_id | ○ |  | フロア検索APIから取得可能なフロアID |
| 読み仮名 | initial |  | う゛ぃくとる | 作者名(読み仮名)をUTF-8で指定、前方一致検索 |
| 取得件数 | hits |  | 100 | 初期値: 100、最大: 500 |
| 検索開始位置 | offset |  | 1 | 初期値: 1 |
| 出力形式 | output |  | json | json / xml |
| コールバック | callback |  | callback | 出力形式が json の場合にJSONPの関数名を指定 |

### レスポンスフィールド

| フィールド | 説明 | 例 |
|---|---|---|
| request.parameters[].name | リクエストパラメータ名 | affiliate_id |
| request.parameters[].value | リクエストパラメータ値 | affiliate-990 |
| result.status | ステータスコード | 200 |
| result.result_count | 取得件数 | 100 |
| result.total_count | 全体件数 | 1000 |
| result.first_position | 検索開始位置 | 1 |
| result.site_name | サイト名 | DMM.com（一般） |
| result.site_code | サイトコード | DMM.com |
| result.service_name | サービス名 | 通販 |
| result.service_code | サービスコード | mono |
| result.floor_id | フロアID | 24 |
| result.floor_name | フロア名 | 本・コミック |
| result.floor_code | フロアコード | book |
| result.author.author_id | 作者ID | 21414 |
| result.author.name | 作者名 | ヴィクトル・ユゴー |
| result.author.ruby | 作者名(読み仮名) | う゛ぃくとるゆごー |
| result.author.another_name | 作者別名 | ヴィクトル・ユーゴー/ヴィクトル=ユーゴー |
| result.author.list_url | リストページURL（アフィリエイトID付き） | https://al.dmm.co.jp/... |