開発者向け
買取価格 Open API
JAN を渡すと、各買取店の現在価格・価格推移・ランキングを JSON で返します。
無料で使える回数
100回/日
会員登録だけで利用可
- エンドポイント3種類
- 認証Bearer
- 形式JSON
はじめかた
- 1. ログインしてマイページの「API」で Key を発行
- 2. Authorization ヘッダーに付けて呼び出す
curl -H "Authorization: Bearer kn_xxxxxxxx" \ https://www.kaitori-pro.app/api/v1/products/4549995648577
エンドポイント
ベース URL：https://www.kaitori-pro.app/api/v1
| パス | 内容 |
|---|---|
| GET/products/{jan} | 各買取店の現在の買取価格（高い順）— |
| GET/products/{jan}/history | 日ごと・店舗ごとの最高買取価格days（既定 30、プランの上限まで） |
| GET/rankings/{type} | 人気・定価差・値上がり・値下がりランキングlimit（1〜100、既定 20） |
ランキングの type：popular-daily / popular-weekly / popular-monthly / profit / price-up / price-down
レスポンス例
/products/{jan}
{
"data": {
"jan": "4549995648577",
"name": "iPhone 17 Pro 256GB コズミックオレンジ",
"retailPrice": 179800,
"maxPrice": 186000,
"maxPriceStore": "森森買取",
"kaitoriRate": 103.4,
"storeCount": 12,
"prices": [
{
"store": "森森買取",
"storeKey": "morimori",
"price": 186000,
"url": "https://...",
"fetchedAt": "2026-11-10T03:12:00.000Z"
}
],
"url": "https://www.kaitori-pro.app/product/4549995648577"
}
}プランと回数
| プラン | 1 日 | 1 分 | 価格推移 |
|---|---|---|---|
| スターター | 100回 | 10回 | 180日 |
| プロ | 1,000回 | 30回 | 365日 |
| ビジネス | 10,000回 | 120回 | 730日 |
回数は日本時間 0 時にリセット。残り回数はレスポンスヘッダー X-RateLimit-Remaining で確認できます。
エラー
形式：{ "error": { "code", "message" } }
- 400invalid_jan / invalid_days / invalid_limitパラメーターの形式が違う
- 401missing_api_key / invalid_api_keyKey が無い・無効・削除済み
- 403plan_limitプランで取れる期間を超えている
- 404not_found / unknown_ranking商品が未掲載・ランキングの種類が違う
- 429rate_limited / daily_limit_exceeded1 分または 1 日の回数を超えた
よくある質問・利用条件
Q.料金はかかりますか？
無料のスターター（会員登録のみ）で 1 日 100 回まで使えます。回数を増やしたいときはプロ（1 日 1,000 回）かビジネス（1 日 10,000 回）に入ってください。API 専用の追加料金はありません。
Q.価格はどのくらい新しいですか？
サイトの商品ページと同じデータです。主要店は 30〜60 分おきに巡回しています。各価格の fetchedAt が店舗で確認した時刻です。API を呼んでも店舗へその場で取りに行くことはありません。
Q.取得したデータを自分のサイトやツールで使えますか？
自社ツール・個人の在庫管理・社内分析などに使えます。データを公開する場合は「買取比較ナビ」の名前と商品ページへのリンクを表示してください。取得したデータをそのまま再配布・販売すること、サイトを丸ごと複製するような使い方は禁止です。
Q.稼働は保証されますか？
できる限り安定して提供しますが、稼働率（SLA）や価格の正確さは保証しません。表示価格は各店が公開している新品・未開封時の参考価格です。仕様は予告なく変わることがあり、大きく変えるときは更新情報でお知らせします。
Q.API Key が漏れたらどうすればいいですか？
マイページの「API」から該当の Key をすぐに削除し、新しい Key を発行してください。削除した Key は即座に使えなくなります。Key はブラウザ側のコードに書かず、サーバー側で使ってください。