リファレンス<DMM.com シリーズ検索API>

シリーズ一覧を取得することが可能がAPIです。

リクエストURL

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

リクエストパラメータ

論理名 物理名 必須 値のサンプル 概要
APIIDapi_id登録時に割り振られたID
アフィリエイトIDaffiliate_idaffiliate-990登録時に割り振られた990~999までのアフィリエイトID
フロアIDfloor_idフロア検索APIから取得可能なフロアID
頭文字(50音)initial50音をUTF-8で指定
取得件数hits100初期値:100 最大:500
検索開始位置offset1初期値:1
出力形式outputjsonjson / xml
コールバックcallbackcallback出力形式jsonで指定した場合に、このパラメータでコールバック関数名を指定すると、JSONP形式で出力されます

レスポンスフィールド

フィールド 説明
request
parameters
└ parameterリクエストパラメータ
  ├ nameパラメータ名affiliate_id
  └ valueaffiliate-990
result
├ statusステータスコード200
├ result_count取得件数100
├ total_count全体件数1000
├ first_position検索開始位置1
├ site_nameサイト名DMM.com(一般)
├ site_codeサイトコードDMM.com
├ service_nameサービス名通販
├ service_codeサービスコードmono
├ floor_idフロアID24
├ floor_nameフロア名本・コミック
├ floor_codeフロアコードbook
└ seriesシリーズ情報
  ├ series_idシリーズID62226
  ├ nameシリーズ名ARIA
  ├ rubyシリーズ名(読み仮名)ありあ
  └ list_urlリストページURL(アフィリエイトID付き)http://www.dmm.com/mono/book/-/list/=/article=series/id=62226/affiliate-990

サンプルレスポンス

{
    "request": {
        "parameters": {
            "api_id": "example",
            "affiliate_id": "affiliate-990",
            "initial": "お",
            "floor_id": "27",
            "hits": "10",
            "output": "json"
        }
    },
    "result": {
        "status": "200",
        "result_count": 10,
        "total_count": "959",
        "first_position": 0,
        "site_name": "DMM.com(一般)",
        "site_code": "DMM.com",
        "service_name": "通販",
        "service_code": "mono",
        "floor_id": "27",
        "floor_name": "本・コミック",
        "floor_code": "book",
        "series": [
            {
                "series_id": "11773",
                "name": "おふらいんげーむ",
                "ruby": "おふらいんげーむ",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=11773/affiliate-990"
            },
            {
                "series_id": "25103",
                "name": "オナペ",
                "ruby": "おなぺ",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=25103/affiliate-990"
            },
            {
                "series_id": "50112",
                "name": "おねがい☆ツインズ",
                "ruby": "おねがいついんず",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50112/affiliate-990"
            },
            {
                "series_id": "50113",
                "name": "おねがい☆ティーチャー",
                "ruby": "おねがいてぃーちゃー",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50113/affiliate-990"
            },
            {
                "series_id": "50219",
                "name": "王妃マルゴ",
                "ruby": "おうひまるご",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50219/affiliate-990"
            },
            {
                "series_id": "50222",
                "name": "沖縄の島へ全部行ってみたサー",
                "ruby": "おきなわのしまえぜんぶいってみたさー",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50222/affiliate-990"
            },
            {
                "series_id": "50225",
                "name": "俺に血まなこ",
                "ruby": "おれにちまなこ",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50225/affiliate-990"
            },
            {
                "series_id": "50226",
                "name": "女には向かない職業",
                "ruby": "おんなにはむかないしょくぎょう",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50226/affiliate-990"
            },
            {
                "series_id": "50474",
                "name": "大人の舌先養成講座",
                "ruby": "おとなのしたさきようせいこうざ",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50474/affiliate-990"
            },
            {
                "series_id": "50716",
                "name": "オーバーマン キングゲイナー",
                "ruby": "おーばーまんきんぐげいなー",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=series/id=50716/affiliate-990"
            }
        ]
    }
}