カテゴリー毎の商品TOP10アイテムが収録されています。
対象商品はデータ対象月までに発売された全商品です。
API利用に関する注意事項を遵守のうえご利用ください。
ご不明点はお問い合わせください。
Resource URL
下記アドレスのカテゴリーNo.を希望のものに変更して取得してください。
| https://ksp-api.com/api/f/ranking/{category-No.} |
Resource Infomation
| 項目 | 説明 |
| リクエスト制限 | **回/分 |
| 地域制限 | 日本国内のIPアドレスに限る |
| HTTP メソッド | GET |
| レスポンスフォーマット | json |
| レスポンスオブジェクト | List |
Request Parameters
category-No.：カテゴリー一覧
| 中分類 | カテゴリーNo. {category-No.} |
カテゴリー名称 |
| 加工食品 |
1103 | レトルトカレー |
| 1203 | 料理の素 | |
| 1303 | 冷凍食品 | |
| 1603 | 惣菜 | |
| 菓子類 | 2103 | チョコレート |
| 2303 | スナック・米菓 | |
| 2403 | キャンディ・グミ | |
| 2503 | アイスクリーム | |
| 2703 | ヨーグルト | |
| 飲料 | 4103 | 炭酸ドリンク |
| 4203 | 茶系ドリンク | |
| 酒類 | 5203 | ビール類 |
| その他食品・日雑 |
6103 | 健康食品 |
| 6503 | ペットフード |
Table Columns Overview
| キー名称 | キー名称（日本語） | 説明 |
| nentk | 年月 | 対象年月 |
| cate_no | カテゴリーNo. | カテゴリー番号 |
| cate_nm | カテゴリー名称 | カテゴリー名称 |
| rank_no | No. | 金額ランキングの順位 |
| item_key | 商品コード | 商品パッケージのバーコード下に記載されている13桁または8桁の数字 |
| item_nm | 商品名称 | KSP-POSに登録されている商品名称 |
| ccate_nm | 中分類名称 | KSP標準分類中分類名称 |
| scate_nm | 小分類名称 | KSP標準分類小分類名称 |
| icate_nm | 細分類名称 | KSP標準分類細分類名称 |
| maker_nm | メーカー名称 | KSP-POSに登録されているメーカー名称 |
| apr_date | 出現日 | KSP-POSに初めて売上が登録された日（商品の発売日と厳密に一致しません） |
| amount_ratio | 金額構成比 | 同一カテゴリーの商品合計に対する金額割合 |
| amount_ratio_mom_diff | 金額構成比前月差 | 同項目の前月差 |
| average_price | 平均価格 | 最新月の売上金額÷売上数量 |
| average_price_yoy_diff | 平均価格前年同月差 | 同項目の前年同月差 |
| weekly_sales_per_store | 1店週あたり販売数量 | 1店舗、1週間あたりの販売数量 例）7月に10店舗で400個売れた場合、400個÷31日×7日間÷10店舗=9.0個） |
| store_rate | 販売店率 | KSP-POS収集店における当月の販売店率 |
Sample Output（2303スナック・米菓）
Copyright © 2025 KSP-SP Co.,LTD. All rights reserved.