ジャンル検索APIリファレンス

ジャンル一覧を取得することが可能なAPIです。

リクエストURL

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
└ parameter	リクエストパラメータ
├ name	パラメータ名	affiliate_id
└ value	値	affiliate-990
result
├ status	ステータスコード	200
├ result_count	取得件数	100
├ total_count	全体件数	1000
├ first_position	検索開始位置	1
├ site_name	サイト名	FANZA（アダルト）
├ site_code	サイトコード	FANZA
├ service_name	サービス名	動画
├ service_code	サービスコード	digital
├ floor_id	フロアID	40
├ floor_name	フロア名	ビデオ
├ floor_code	フロアコード	videoa
└ genre	ジャンル情報
├ genre_id	ジャンルID	2001
├ name	ジャンル名	巨乳
├ ruby	ジャンル名(読み仮名)	きょにゅう
└ list_url	リストページURL（アフィリエイトID付き）	https://al.dmm.co.jp/?lurl=http%3A%2F%2Fwww.dmm.co.jp%2Fdigital%2Fvideoa%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D2001%2F&af_id=affiliate-001&ch=api

サンプルレスポンス

{
    "request": {
        "parameters": {
            "api_id": "example",
            "affiliate_id": "affiliate-990",
            "floor_id": "25",
            "initial": "き",
            "hits": "10",
            "offset": "10",
            "output": "json"
        }
    },
    "result": {
        "status": "200",
        "result_count": 10,
        "total_count": "20",
        "first_position": 10,
        "site_name": "DMM.com（一般）",
        "site_code": "DMM.com",
        "service_name": "通販",
        "service_code": "mono",
        "floor_id": "25",
        "floor_name": "DVD・Blu-ray",
        "floor_code": "dvd",
        "genre": [
            {
                "genre_id": "73115",
                "name": "キャラクター",
                "ruby": "きゃらくたー",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D73115%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "78012",
                "name": "キャラクター",
                "ruby": "きゃらくたー",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D78012%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "138",
                "name": "キャンペーン対象商品",
                "ruby": "きゃんぺーんたいしょうしょうひん",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D138%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "73145",
                "name": "教育",
                "ruby": "きょういく",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D73145%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "66352",
                "name": "競泳・スクール水着",
                "ruby": "きょうえいすくーるみずぎ",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D66352%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "71142",
                "name": "近未来",
                "ruby": "きんみらい",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D71142%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "72138",
                "name": "近未来",
                "ruby": "きんみらい",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D72138%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "78038",
                "name": "近未来",
                "ruby": "きんみらい",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D78038%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "73130",
                "name": "近未来",
                "ruby": "きんみらい",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D73130%2F&af_id=affiliate-990&ch=api"
            },
            {
                "genre_id": "70027",
                "name": "近未来",
                "ruby": "きんみらい",
                "list_url": "https://al.dmm.com/?lurl=https%3A%2F%2Fwww.dmm.com%2Fmono%2Fdvd%2F-%2Flist%2F%3D%2Farticle%3Dkeyword%2Fid%3D70027%2F&af_id=affiliate-990&ch=api"
            }
        ]
    }
}