カテゴリランキング(v2)

Yahoo!ショッピングの商品の売り上げランキング情報を取得することが可能なAPIです。

リクエストURL

URL
https://shopping.yahooapis.jp/ShoppingWebService/V2/categoryRanking

リクエストパラメータ

RESTリクエストの構築(GET)」をご参照ください。

パラメータ 説明
appid
(必須)
string アプリケーションID。詳細はこちらをご覧ください。
affiliate_type vc バリューコマースアフィリエイト(vc)を選択。
例:affiliate_type=vc
affiliate_id string バリューコマースアフィリエイトIDを入力。
category_id integer カテゴリIDを指定して使用。デフォルトは、全カテゴリからのランキング
gender male/female 男性(male)、女性(female)の選択。指定なしだと全体のランキングを返す。
例:gender=male
generation integer 取得したい年齢の年代を指定。指定無しだと全世代
例:20代のランキングを表示 generation=20
all : 総合(世代不明を含む)
10 : 10代(0~19歳)
20 : 20代
30 : 30代
40 : 40代
50 : 50代(50代以上)
period weekly/daily 週間とデイリーでランキングの期間を指定、指定なしの場合はデイリーを返す。
offset integer 指定した順位を20位毎に表示。
offset=1だと1位から20位まで、offset=21だと21位から40位までのランキング情報を返す。

サンプルリクエストURL

https://shopping.yahooapis.jp/ShoppingWebService/V2/categoryRanking?appid=<あなたのアプリケーションID>&category_id=2494&gender=female&generation=20

レスポンスフィールド

path 説明
/category_ranking/ ルート要素
検索条件
/category_ranking/conditions/
/category_ranking/conditions/category_id カテゴリID
/category_ranking/conditions/gender 性別
/category_ranking/conditions/generation 年代
/category_ranking/conditions/period ランキング集計期間
/category_ranking/conditions/offset 順位指定
メタ情報
/category_ranking/meta/ メタ要素
/category_ranking/meta/last_modified ランキング更新日付(YYYY-MM-DD)
/category_ranking/meta/start_date 集計開始日(YYYY-MM-DD)
/category_ranking/meta/end_date 集計終了日(YYYY-MM-DD)
/category_ranking/meta/total_results_returned 取得件数
/category_ranking/meta/total_results_available ランキング件数
検索結果
/category_ranking/ranking_data ランキング要素
/category_ranking/ranking_data/rank 順位
/category_ranking/ranking_data/name 商品名
/category_ranking/ranking_data/url 商品URL
検索結果 - image項目
/category_ranking/ranking_data/image 画像要素
/category_ranking/ranking_data/image/id 画像ID
/category_ranking/ranking_data/image/small 76×76サイズ画像URL
/category_ranking/ranking_data/image/medium 146×146サイズの画像URL
検索結果 - review項目
/category_ranking/ranking_data/reivew レビュー要素
/category_ranking/ranking_data/review/rate レビュー評価
/category_ranking/ranking_data/review/count レビュー件数
/category_ranking/ranking_data/review/url レビューURL
検索結果 - store項目
/category_ranking/ranking_data/store ストア要素
/category_ranking/ranking_data/store/id ストアID
/category_ranking/ranking_data/store/name ストア名
/category_ranking/ranking_data/store/url ストアURL
カテゴリ情報
/category_ranking/categories カテゴリ要素
カテゴリ情報 - current項目
/category_ranking/categories/current/ 指定カテゴリ情報
/category_ranking/categories/current/id カテゴリID
/category_ranking/categories/current/parent_id 親カテゴリID
/category_ranking/categories/current/url カテゴリURL
カテゴリ情報 - currentのtitle情報
/category_ranking/categories/current/title タイトル情報
/category_ranking/categories/current/title/short カテゴリ名
/category_ranking/categories/current/title/medium カテゴリパス名1
/category_ranking/categories/current/title/long カテゴリパス名2
カテゴリ情報 - currentのpath情報
/category_ranking/categories/current/path/category パス要素
/category_ranking/categories/current/path/category/depth トップからのカテゴリの深さ
/category_ranking/categories/current/path/category/id カテゴリID(カテゴリパス用)
/category_ranking/categories/current/path/category/parent_id 親カテゴリID(カテゴリパス用)
カテゴリ情報 - currentのpathのタイトル情報
/category_ranking/categories/current/path/category/title パスのタイトル要素
/category_ranking/categories/current/path/category/title/name カテゴリ名(カテゴリパス用)
カテゴリ情報 - children項目
/category_ranking/categories/children/ 子カテゴリパス要素
カテゴリ情報 - child項目
/category_ranking/categories/children/child 子カテゴリ要素
/category_ranking/categories/children/child/sort_order ソート順
/category_ranking/categories/children/child/id カテゴリID
/category_ranking/categories/children/child/url カテゴリURL
カテゴリ情報 - childのtitle項目
/category_ranking/categories/children/child/title 子カテゴリのタイトル情報
/category_ranking/categories/children/child/title/short カテゴリ名(子カテゴリパス用)
/category_ranking/categories/children/child/title/medium カテゴリパス名1(子カテゴリパス用)
/category_ranking/categories/children/child/title/medium カテゴリパス名2(子カテゴリパス用)

サンプルレスポンス

以下は、総合ランキング情報(カテゴリID指定なし)のリクエストに対するレスポンスです。

{
    "category_ranking": {
        "conditions": {
            "last_modified": "2020-10-28",
            "start_date": "2020-10-27",
            "end_date": "2020-10-27",
            "category_id": "1",
            "gender": null,
            "generation": null,
            "period": "daily",
            "total_results_available": 20,
            "first_results_position": 1,
            "total_results_returned": 1000
        },
        "ranking_data": [
            {
                "rank": 1,
                "name": "鬼剥離の粉 油汚れ用粉末洗剤 マルチクリーナー 1000g くらしの応援クーポン",
                "url": "https://paypaymall.yahoo.co.jp/store/copa/item/t0101200/",
                "image": {
                    "id": "copa_t0101200",
                    "small": "http://item.shopping.c.yimg.jp/i/c/copa_t0101200",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/copa_t0101200"
                },
                "review": {
                    "rate": 5,
                    "count": 1,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=copa&page_key=t0101200"
                },
                "store": {
                    "id": "copa",
                    "name": "コパ・コーポレーション",
                    "url": "http://store.shopping.yahoo.co.jp/copa/index.html"
                }
            },
            {
                "rank": 2,
                "name": "不織布 マスク 50枚 99%カットフィルター採用 3層構造 不織布マスク 使い捨て 平ゴム 耳に優しい マスク 白 ウイルス 花粉 ハウスダスト",
                "url": "https://store.shopping.yahoo.co.jp/pickupplazashop/bwm1yp50-a.html",
                "image": {
                    "id": "pickupplazashop_bwm1yp50-a",
                    "small": "http://item.shopping.c.yimg.jp/i/c/pickupplazashop_bwm1yp50-a",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/pickupplazashop_bwm1yp50-a"
                },
                "review": {
                    "rate": 4.21,
                    "count": 10222,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=pickupplazashop&page_key=bwm1yp50-a"
                },
                "store": {
                    "id": "pickupplazashop",
                    "name": "pickupplazashop",
                    "url": "http://store.shopping.yahoo.co.jp/pickupplazashop/index.html"
                }
            },
            {
                "rank": 3,
                "name": "【最大15%OFF!クーポン対象】 マスク 蒸れない 3枚入 潤い 秋冬用 個包装 当日発送 洗える UVカット 花粉 ウィルス 飛沫 感染予防 送料無料",
                "url": "https://store.shopping.yahoo.co.jp/importitem/mask5-3ss.html",
                "image": {
                    "id": "importitem_mask5-3ss",
                    "small": "http://item.shopping.c.yimg.jp/i/c/importitem_mask5-3ss",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/importitem_mask5-3ss"
                },
                "review": {
                    "rate": 3.77,
                    "count": 285,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=importitem&page_key=mask5-3ss"
                },
                "store": {
                    "id": "importitem",
                    "name": "インポートアイテム",
                    "url": "http://store.shopping.yahoo.co.jp/importitem/index.html"
                }
            },
            {
                "rank": 4,
                "name": "米 送料無料 お米 広島県産 コシヒカリ 安心栽培 200円 お米 お試し ポイント消化 令和2年産 150g ※メール便のため日時指定・代引不可",
                "url": "https://store.shopping.yahoo.co.jp/y-shokuken/sk011.html",
                "image": {
                    "id": "y-shokuken_sk011",
                    "small": "http://item.shopping.c.yimg.jp/i/c/y-shokuken_sk011",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/y-shokuken_sk011"
                },
                "review": {
                    "rate": 4.34,
                    "count": 6641,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=y-shokuken&page_key=sk011"
                },
                "store": {
                    "id": "y-shokuken",
                    "name": "米穀店 食の健康社",
                    "url": "http://store.shopping.yahoo.co.jp/y-shokuken/index.html"
                }
            },
            {
                "rank": 5,
                "name": "マスク 50枚 + 1枚 51枚入り 在庫有り 箱入り 不織布マスク 大人用 子供用 三層構造 ウイルス 花粉対策 飛沫防止 予防抗菌 不織布 三層構造 送料無料",
                "url": "https://store.shopping.yahoo.co.jp/i-concept/zzsur.html",
                "image": {
                    "id": "i-concept_zzsur",
                    "small": "http://item.shopping.c.yimg.jp/i/c/i-concept_zzsur",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/i-concept_zzsur"
                },
                "review": {
                    "rate": 4.19,
                    "count": 1618,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=i-concept&page_key=zzsur"
                },
                "store": {
                    "id": "i-concept",
                    "name": "i-concept",
                    "url": "http://store.shopping.yahoo.co.jp/i-concept/index.html"
                }
            },
            {
                "rank": 6,
                "name": "ミックスナッツ 4種入り 850g 送料無料 選べるハッピーミックスナッツ アーモンド 生くるみ カシューナッツ マカダミアナッツ 無塩 有塩 SALE 非常食",
                "url": "https://paypaymall.yahoo.co.jp/store/shizennoyakata/item/mixnutsofaphantom-spsale/",
                "image": {
                    "id": "shizennoyakata_mixnutsofaphantom-spsale",
                    "small": "http://item.shopping.c.yimg.jp/i/c/shizennoyakata_mixnutsofaphantom-spsale",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/shizennoyakata_mixnutsofaphantom-spsale"
                },
                "review": {
                    "rate": 4.56,
                    "count": 7578,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=shizennoyakata&page_key=mixnutsofaphantom-spsale"
                },
                "store": {
                    "id": "shizennoyakata",
                    "name": "美味しさは元気の源 自然の館",
                    "url": "http://store.shopping.yahoo.co.jp/shizennoyakata/index.html"
                }
            },
            {
                "rank": 7,
                "name": "緑茶 ティーバッグ お徳用 抹茶入り 深蒸し茶ティーパック (2.5g×100包入) お茶 掛川茶 静岡茶 送料無料 業務用 水出し茶 日本茶 煎茶",
                "url": "https://store.shopping.yahoo.co.jp/chatsuminosato/1340.html",
                "image": {
                    "id": "chatsuminosato_1340",
                    "small": "http://item.shopping.c.yimg.jp/i/c/chatsuminosato_1340",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/chatsuminosato_1340"
                },
                "review": {
                    "rate": 4.6,
                    "count": 476,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=chatsuminosato&page_key=1340"
                },
                "store": {
                    "id": "chatsuminosato",
                    "name": "掛川茶通販 茶つみの里",
                    "url": "http://store.shopping.yahoo.co.jp/chatsuminosato/index.html"
                }
            },
            {
                "rank": 8,
                "name": "iPhone 充電ケーブル 充電器 コード 1m 1.5m 25cm 50cm 急速充電 断線防止 強化素材 iPhone12 11 iPhoneX iPhone各種 モバイルバッテリー planetcord 90日保証",
                "url": "https://store.shopping.yahoo.co.jp/i-concept/lusb.html",
                "image": {
                    "id": "i-concept_lusb",
                    "small": "http://item.shopping.c.yimg.jp/i/c/i-concept_lusb",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/i-concept_lusb"
                },
                "review": {
                    "rate": 4.38,
                    "count": 3661,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=i-concept&page_key=lusb"
                },
                "store": {
                    "id": "i-concept",
                    "name": "i-concept",
                    "url": "http://store.shopping.yahoo.co.jp/i-concept/index.html"
                }
            },
            {
                "rank": 9,
                "name": "やさい酵素 酵素 サプリメント お試し 送料無料 ダイエット サプリ 生酵素 酵素サプリ 野菜 野草 約1ヶ月分",
                "url": "https://paypaymall.yahoo.co.jp/store/oga/item/b-yk1/",
                "image": {
                    "id": "oga_b-yk1",
                    "small": "http://item.shopping.c.yimg.jp/i/c/oga_b-yk1",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/oga_b-yk1"
                },
                "review": {
                    "rate": 4.27,
                    "count": 10085,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=oga&page_key=b-yk1"
                },
                "store": {
                    "id": "oga",
                    "name": "オーガランド PayPayモール店",
                    "url": "http://store.shopping.yahoo.co.jp/oga/index.html"
                }
            },
            {
                "rank": 10,
                "name": "マスク 50枚 在庫あり 送料無料 大人用 ウィルス 花粉症対策 三層構造 不織布マスク 男女兼用",
                "url": "https://paypaymall.yahoo.co.jp/store/cincshop/item/cinc-y-1354/",
                "image": {
                    "id": "cincshop_cinc-y-1354",
                    "small": "http://item.shopping.c.yimg.jp/i/c/cincshop_cinc-y-1354",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/cincshop_cinc-y-1354"
                },
                "review": {
                    "rate": 4.1,
                    "count": 9418,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=cincshop&page_key=cinc-y-1354"
                },
                "store": {
                    "id": "cincshop",
                    "name": "CINC SHOP PayPayモール店",
                    "url": "http://store.shopping.yahoo.co.jp/cincshop/index.html"
                }
            },
            {
                "rank": 11,
                "name": "福袋 ファーファ 洗剤・柔軟剤が入ったセット 送料無料",
                "url": "https://store.shopping.yahoo.co.jp/fafa-online/900010.html",
                "image": {
                    "id": "fafa-online_900010",
                    "small": "http://item.shopping.c.yimg.jp/i/c/fafa-online_900010",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/fafa-online_900010"
                },
                "review": {
                    "rate": 4.64,
                    "count": 14,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=fafa-online&page_key=900010"
                },
                "store": {
                    "id": "fafa-online",
                    "name": "ファーファオンラインYahoo!店",
                    "url": "http://store.shopping.yahoo.co.jp/fafa-online/index.html"
                }
            },
            {
                "rank": 12,
                "name": "洗たくマグちゃん 8個分の容量 マグネシウム 純マグネシウム粒 400g 洗濯 お風呂 掃除 水素浴 除菌 洗浄 消臭 DIY 水素水 高純度99.9%以上",
                "url": "https://store.shopping.yahoo.co.jp/suhada/magnesium.html",
                "image": {
                    "id": "suhada_magnesium",
                    "small": "http://item.shopping.c.yimg.jp/i/c/suhada_magnesium",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/suhada_magnesium"
                },
                "review": {
                    "rate": 4.55,
                    "count": 215,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=suhada&page_key=magnesium"
                },
                "store": {
                    "id": "suhada",
                    "name": "素肌べっぴん館",
                    "url": "http://store.shopping.yahoo.co.jp/suhada/index.html"
                }
            },
            {
                "rank": 13,
                "name": "ダスキン スポンジ 台所用3色セット抗菌タイプS 2パック(6個)真空包装 空気穴 納品書無し 定型外郵便",
                "url": "https://store.shopping.yahoo.co.jp/dasuwan/sinnku-dsss-002.html",
                "image": {
                    "id": "dasuwan_sinnku-dsss-002",
                    "small": "http://item.shopping.c.yimg.jp/i/c/dasuwan_sinnku-dsss-002",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/dasuwan_sinnku-dsss-002"
                },
                "review": {
                    "rate": 4.86,
                    "count": 7,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=dasuwan&page_key=sinnku-dsss-002"
                },
                "store": {
                    "id": "dasuwan",
                    "name": "ダスワン",
                    "url": "http://store.shopping.yahoo.co.jp/dasuwan/index.html"
                }
            },
            {
                "rank": 14,
                "name": "送料無料 ご当地ラーメン2食 札幌 味噌ラーメン 1食あたり100円 送料無 食品 送料無 ポイント消化 200円 送料無 お試し 食品 ラーメン 取り寄せ ご当地グルメ",
                "url": "https://store.shopping.yahoo.co.jp/banya-food/g-ougonsio.html",
                "image": {
                    "id": "banya-food_g-ougonsio",
                    "small": "http://item.shopping.c.yimg.jp/i/c/banya-food_g-ougonsio",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/banya-food_g-ougonsio"
                },
                "review": {
                    "rate": 4.3,
                    "count": 721,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=banya-food&page_key=g-ougonsio"
                },
                "store": {
                    "id": "banya-food",
                    "name": "どんまい生活館",
                    "url": "http://store.shopping.yahoo.co.jp/banya-food/index.html"
                }
            },
            {
                "rank": 15,
                "name": "iPhone 充電 ケーブル 2m 1m 1.5m 3m 0.3m 急速充電 充電器 データ転送ケーブル USBケーブル 充電ケーブル Micro USB Type-C 互換",
                "url": "https://paypaymall.yahoo.co.jp/store/cincshop/item/cinc-y-0652/",
                "image": {
                    "id": "cincshop_cinc-y-0652",
                    "small": "http://item.shopping.c.yimg.jp/i/c/cincshop_cinc-y-0652",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/cincshop_cinc-y-0652"
                },
                "review": {
                    "rate": 4.18,
                    "count": 6746,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=cincshop&page_key=cinc-y-0652"
                },
                "store": {
                    "id": "cincshop",
                    "name": "CINC SHOP PayPayモール店",
                    "url": "http://store.shopping.yahoo.co.jp/cincshop/index.html"
                }
            },
            {
                "rank": 16,
                "name": "iPhoneケーブル 長さ 0.25m 0.5m 1m 1.5m 急速充電 充電器 データ転送ケーブル USBケーブル iPad iPhone用 充電ケーブル XS Max XR X 8 7 6s/6/PLUS 3か月保証",
                "url": "https://paypaymall.yahoo.co.jp/store/meiseishop/item/246/",
                "image": {
                    "id": "meiseishop_246",
                    "small": "http://item.shopping.c.yimg.jp/i/c/meiseishop_246",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/meiseishop_246"
                },
                "review": {
                    "rate": 4.31,
                    "count": 51044,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=meiseishop&page_key=246"
                },
                "store": {
                    "id": "meiseishop",
                    "name": "明誠ショップ",
                    "url": "http://store.shopping.yahoo.co.jp/meiseishop/index.html"
                }
            },
            {
                "rank": 17,
                "name": "マスク 蒸れない 秋用 涼しめ ウレタンマスク 在庫あり 立体 大人用 子供用 3D 洗える 花粉対策 風邪 ウイルス 5枚セット 送料無料",
                "url": "https://store.shopping.yahoo.co.jp/i-concept/zzmsk-5.html",
                "image": {
                    "id": "i-concept_zzmsk-5",
                    "small": "http://item.shopping.c.yimg.jp/i/c/i-concept_zzmsk-5",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/i-concept_zzmsk-5"
                },
                "review": {
                    "rate": 3.88,
                    "count": 4137,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=i-concept&page_key=zzmsk-5"
                },
                "store": {
                    "id": "i-concept",
                    "name": "i-concept",
                    "url": "http://store.shopping.yahoo.co.jp/i-concept/index.html"
                }
            },
            {
                "rank": 18,
                "name": "マスク 51枚 使い捨て 箱 日本発送 メルトブローン 不織布 男女兼用 ウィルス対策 BFE 99%以上 ウイルス 防塵 花粉 飛沫感染対策 災害 非常時 防災 ny263",
                "url": "https://paypaymall.yahoo.co.jp/store/akaneashop/item/ny263/",
                "image": {
                    "id": "akaneashop_ny263",
                    "small": "http://item.shopping.c.yimg.jp/i/c/akaneashop_ny263",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/akaneashop_ny263"
                },
                "review": {
                    "rate": 4.01,
                    "count": 2874,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=akaneashop&page_key=ny263"
                },
                "store": {
                    "id": "akaneashop",
                    "name": "アカネA SHOP PayPayモール店",
                    "url": "http://store.shopping.yahoo.co.jp/akaneashop/index.html"
                }
            },
            {
                "rank": 19,
                "name": "コンタクト ワンデー 最安値に挑戦! 1箱あたり874円+税 1箱30枚入り TeAmo 1DAY CLEAR 送料無料 コンタクトレンズ 石田ニコル ティアモ クリア 処方箋不要",
                "url": "https://paypaymall.yahoo.co.jp/store/teamo/item/teamoclear/",
                "image": {
                    "id": "teamo_teamoclear",
                    "small": "http://item.shopping.c.yimg.jp/i/c/teamo_teamoclear",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/teamo_teamoclear"
                },
                "review": {
                    "rate": 4.36,
                    "count": 1465,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=teamo&page_key=teamoclear"
                },
                "store": {
                    "id": "teamo",
                    "name": "コンタクトレンズのTeAmo",
                    "url": "http://store.shopping.yahoo.co.jp/teamo/index.html"
                }
            },
            {
                "rank": 20,
                "name": "iPhone 保護フィルム ガラスフィルム ブルーライトカット iPhone11 iPhone se2 iPhoneXR iPhoneXS Max iPhone8 7 Plus 各種対応 硬度9H アイフォン セール",
                "url": "https://store.shopping.yahoo.co.jp/i-concept/fk.html",
                "image": {
                    "id": "i-concept_fk",
                    "small": "http://item.shopping.c.yimg.jp/i/c/i-concept_fk",
                    "medium": "http://item.shopping.c.yimg.jp/i/g/i-concept_fk"
                },
                "review": {
                    "rate": 4.05,
                    "count": 33748,
                    "url": "http://shopping.yahoo.co.jp/review/item/list?store_id=i-concept&page_key=fk"
                },
                "store": {
                    "id": "i-concept",
                    "name": "i-concept",
                    "url": "http://store.shopping.yahoo.co.jp/i-concept/index.html"
                }
            }
        ],
        "categories": {
            "current": {
                "id": "1",
                "parent_id": "0",
                "url": "",
                "title": {
                    "short": "Shopping",
                    "medium": null,
                    "long": null
                },
                "path": {
                    "category": [
                        {
                            "depth": 1,
                            "id": "1",
                            "parent_id": "0",
                            "title": {
                                "name": "Shopping"
                            }
                        }
                    ]
                }
            },
            "children": {
                "child": [
                    {
                        "sort_order": 10,
                        "id": "13457",
                        "url": "http://shopping.yahoo.co.jp/category/13457/recommend",
                        "title": {
                            "short": "ファッション",
                            "medium": "ファッション",
                            "long": "ファッション"
                        }
                    },
                    {
                        "sort_order": 20,
                        "id": "2498",
                        "url": "http://shopping.yahoo.co.jp/category/2498/recommend",
                        "title": {
                            "short": "食品",
                            "medium": "食品",
                            "long": "食品"
                        }
                    },
                    {
                        "sort_order": 30,
                        "id": "2513",
                        "url": "http://shopping.yahoo.co.jp/category/2513/recommend",
                        "title": {
                            "short": "アウトドア、釣り、旅行用品",
                            "medium": "アウトドア、釣り、旅行用品",
                            "long": "アウトドア、釣り、旅行用品"
                        }
                    },
                    {
                        "sort_order": 40,
                        "id": "2500",
                        "url": "http://shopping.yahoo.co.jp/category/2500/recommend",
                        "title": {
                            "short": "ダイエット、健康",
                            "medium": "ダイエット、健康グッズ",
                            "long": "ダイエット、健康"
                        }
                    },
                    {
                        "sort_order": 50,
                        "id": "2501",
                        "url": "http://shopping.yahoo.co.jp/category/2501/recommend",
                        "title": {
                            "short": "コスメ、美容、ヘアケア",
                            "medium": "コスメ、美容、ヘアケア",
                            "long": "コスメ、美容、ヘアケア"
                        }
                    },
                    {
                        "sort_order": 60,
                        "id": "2502",
                        "url": "http://shopping.yahoo.co.jp/category/2502/recommend",
                        "title": {
                            "short": "スマホ、タブレット、パソコン",
                            "medium": "スマホ、タブレット、パソコン",
                            "long": "スマホ、タブレット、PC"
                        }
                    },
                    {
                        "sort_order": 70,
                        "id": "2504",
                        "url": "http://shopping.yahoo.co.jp/category/2504/recommend",
                        "title": {
                            "short": "テレビ、オーディオ、カメラ",
                            "medium": "テレビ、オーディオ、カメラ",
                            "long": "テレビ、オーディオ、カメラ"
                        }
                    },
                    {
                        "sort_order": 80,
                        "id": "2505",
                        "url": "http://shopping.yahoo.co.jp/category/2505/recommend",
                        "title": {
                            "short": "家電",
                            "medium": "家電",
                            "long": "家電"
                        }
                    },
                    {
                        "sort_order": 90,
                        "id": "2506",
                        "url": "http://shopping.yahoo.co.jp/category/2506/recommend",
                        "title": {
                            "short": "家具、インテリア",
                            "medium": "家具、インテリア用品",
                            "long": "家具、インテリア"
                        }
                    },
                    {
                        "sort_order": 100,
                        "id": "2507",
                        "url": "http://shopping.yahoo.co.jp/category/2507/recommend",
                        "title": {
                            "short": "花、ガーデニング",
                            "medium": "花、ガーデニング",
                            "long": "花、ガーデニング"
                        }
                    },
                    {
                        "sort_order": 110,
                        "id": "2508",
                        "url": "http://shopping.yahoo.co.jp/category/2508/recommend",
                        "title": {
                            "short": "キッチン、日用品、文具",
                            "medium": "キッチン、日用品、文具",
                            "long": "キッチン、日用品、文具"
                        }
                    },
                    {
                        "sort_order": 120,
                        "id": "2503",
                        "url": "http://shopping.yahoo.co.jp/category/2503/recommend",
                        "title": {
                            "short": "DIY、工具",
                            "medium": "DIY、工具",
                            "long": "DIY、工具"
                        }
                    },
                    {
                        "sort_order": 130,
                        "id": "2509",
                        "url": "http://shopping.yahoo.co.jp/category/2509/recommend",
                        "title": {
                            "short": "ペット用品、生き物",
                            "medium": "ペット用品、生き物",
                            "long": "ペット用品、生き物"
                        }
                    },
                    {
                        "sort_order": 140,
                        "id": "2510",
                        "url": "http://shopping.yahoo.co.jp/category/2510/recommend",
                        "title": {
                            "short": "楽器、手芸、コレクション",
                            "medium": "楽器、手芸、コレクション",
                            "long": "楽器、手芸、コレクション"
                        }
                    },
                    {
                        "sort_order": 150,
                        "id": "2511",
                        "url": "http://shopping.yahoo.co.jp/category/2511/recommend",
                        "title": {
                            "short": "ゲーム、おもちゃ",
                            "medium": "ゲーム、おもちゃ",
                            "long": "ゲーム、おもちゃ"
                        }
                    },
                    {
                        "sort_order": 160,
                        "id": "2497",
                        "url": "http://shopping.yahoo.co.jp/category/2497/recommend",
                        "title": {
                            "short": "ベビー、キッズ、マタニティ",
                            "medium": "ベビー、キッズ、マタニティ",
                            "long": "ベビー、キッズ、マタニティ"
                        }
                    },
                    {
                        "sort_order": 170,
                        "id": "2512",
                        "url": "http://shopping.yahoo.co.jp/category/2512/recommend",
                        "title": {
                            "short": "スポーツ",
                            "medium": "スポーツ用品",
                            "long": "スポーツ"
                        }
                    },
                    {
                        "sort_order": 180,
                        "id": "2514",
                        "url": "http://shopping.yahoo.co.jp/category/2514/recommend",
                        "title": {
                            "short": "車、バイク、自転車",
                            "medium": "車、バイク、自転車",
                            "long": "車、バイク、自転車"
                        }
                    },
                    {
                        "sort_order": 190,
                        "id": "2516",
                        "url": "http://shopping.yahoo.co.jp/category/2516/recommend",
                        "title": {
                            "short": "CD、音楽ソフト、チケット",
                            "medium": "CD、音楽ソフト",
                            "long": "CD、レコード、音楽ソフト、チケット"
                        }
                    },
                    {
                        "sort_order": 200,
                        "id": "2517",
                        "url": "http://shopping.yahoo.co.jp/category/2517/recommend",
                        "title": {
                            "short": "DVD、映像ソフト",
                            "medium": "DVD、映像ソフト",
                            "long": "DVD、映像ソフト"
                        }
                    },
                    {
                        "sort_order": 210,
                        "id": "10002",
                        "url": "http://shopping.yahoo.co.jp/category/10002/recommend",
                        "title": {
                            "short": "本、雑誌、コミック",
                            "medium": "本、雑誌、コミック",
                            "long": "本、雑誌、コミック"
                        }
                    },
                    {
                        "sort_order": 220,
                        "id": "47727",
                        "url": "http://shopping.yahoo.co.jp/category/47727/recommend",
                        "title": {
                            "short": "レンタル、各種サービス",
                            "medium": "レンタル、各種サービス",
                            "long": "レンタル、各種サービス"
                        }
                    }
                ]
            }
        }
    }
}

エラー

カテゴリランキングはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

コード 説明
400 Bad request. 渡されたパラメータがWeb APIで期待されたものと一致しない場合に返されます。
401 Unauthorized. 許可されていないアクセスであった場合に返されます。
403 Forbidden. リソースへのアクセスを許されていないか、利用制限を超えている場合に適用されます。
アプリケーションIDが削除された場合にも返されます。
404 Not Found. 指定されたリソースが見つからない場合に返されます。
500 Internal Server Error. 内部的な問題によってデータを返すことができない場合に返されます。

利用約款

このAPIに関する利用約款はこちら

アプリケーションの管理

開発のヒント