カテゴリー毎の新商品TOP10アイテムが収録されています。
対象商品はデータ対象月までの過去3か月間に発売された新商品です。
API利用に関する注意事項を遵守のうえご利用ください。
ご不明点はお問い合わせください。
Resource URL
下記アドレスのカテゴリーNo.を希望のものに変更して取得してください。
| https://ksp-api.com/api/f/newRanking/{category-No.} |
Resource Infomation
| 項目 | 説明 |
| リクエスト制限 | **回/分 |
| 地域制限 | 日本国内のIPアドレスに限る |
| HTTP メソッド | GET |
| レスポンスフォーマット | json |
| レスポンスオブジェクト | List |
Request Parameters
category-No.：カテゴリー一覧
| 中分類 | カテゴリーNo. {category-No.} |
カテゴリー名称 |
| 加工食品 | 1403 | カップ麺 |
| 1503 | パン類 | |
| 菓子類 | 2103 | チョコレート |
| 2203 | スナック | |
| 2403 | キャンディ・グミ | |
| 2503 | アイスクリーム | |
| 2603 | チルドデザート | |
| 飲料 | 4103 | 炭酸ドリンク |
| 4203 | 茶系ドリンク | |
| 酒類 | 5103 | RTD |
| 5203 | ビール類 |
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 | 金額 | KSP-POSにおける最新月の売上金額 |
| average_price | 平均価格 | 最新月の売上金額÷売上数量 |
| store_rate | 販売店率 | KSP-POS収集店における当月の販売店率 |
| weekly_sales_per_store | 1店週あたり販売数量 | 1店舗、1週間あたりの販売数量 例）7月に10店舗で400個売れた場合、400個÷31日×7日間÷10店舗=9.0個） |
| new_amount_ratio | 新商品金額構成比 | 同一カテゴリー内の直近3ヶ月の新商品計に対する金額割合（新商品は出現日で判定しています） |
| amount_ratio | 金額構成比 | 同一カテゴリー内全商品に対する金額割合 |
Sample Output（1403カップ麺）
Copyright © 2025 KSP-SP Co.,LTD. All rights reserved.