リファレンス<DMM.com 作者検索API>

作者一覧を取得することが可能がAPIです。

リクエストURL

https://api.dmm.com/affiliate/v3/AuthorSearch?api_id=[APIID]&affiliate_id=[アフィリエイトID]&iniital=%e3%81%86&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
└ author作者情報
  ├ author_id作者ID21414
  ├ name作者名ヴィクトル・ユゴー
  ├ ruby作者名(読み仮名)う゛ぃくとるゆごー
  ├ another_name作者別名ヴィクトル・ユーゴー/ヴィクトル=ユーゴー
  └ list_urlリストページURL(アフィリエイトID付き)http://www.dmm.com/mono/book/-/list/=/article=author/id=21414/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": "2500",
        "first_position": 0,
        "site_name": "DMM.com(一般)",
        "site_code": "DMM.com",
        "service_name": "通販",
        "service_code": "mono",
        "floor_id": "27",
        "floor_name": "本・コミック",
        "floor_code": "book",
        "author": [
            {
                "author_id": "20085",
                "name": "WIZ",
                "ruby": "うぃず",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20085/devmarketing-990"
            },
            {
                "author_id": "20337",
                "name": "宇佐美渉",
                "ruby": "うさみわたる",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20337/devmarketing-990"
            },
            {
                "author_id": "20557",
                "name": "嬉野めぐみ",
                "ruby": "うれしのめぐみ",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20557/devmarketing-990"
            },
            {
                "author_id": "20594",
                "name": "宇井野りお",
                "ruby": "ういのりお",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20594/devmarketing-990"
            },
            {
                "author_id": "20657",
                "name": "上原ひびき",
                "ruby": "うえはらひびき",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20657/devmarketing-990"
            },
            {
                "author_id": "20658",
                "name": "上田毅八郎",
                "ruby": "うえだきはちろう",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20658/devmarketing-990"
            },
            {
                "author_id": "20659",
                "name": "上田信",
                "ruby": "うえだしん",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20659/devmarketing-990"
            },
            {
                "author_id": "20809",
                "name": "宇治敏彦",
                "ruby": "うじとしひこ",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=20809/devmarketing-990"
            },
            {
                "author_id": "21064",
                "name": "上杉隼人",
                "ruby": "うえすぎはやと",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=21064/devmarketing-990"
            },
            {
                "author_id": "21067",
                "name": "上野圭一",
                "ruby": "うえのけいいち",
                "list_url": "http://www.dmm.com/mono/book/-/list/=/article=author/id=21067/devmarketing-990"
            }
        ]
    }
}