買取X Open API v1 リファレンス
Open API を利用するには認証が必要です。2つの方法があります:
マイページでAPI Keyを取得し、リクエストに含めます。
Authorization: Bearer ktx_your_api_key_here
またはクエリパラメータ:
GET /open/api/product/4549995649284?key=ktx_your_api_key_here
kaitorix.app にGoogleログイン済みの場合、Cookieで自動認証されます。
| プラン | 月額(税込) | 日次リクエスト | 取得方法 |
|---|---|---|---|
| Free | 無料 | 30回/日 | Google ログインで自動付与 |
| Premium | 1,480円 | 500回/日 | サブスクリプションページから申込 |
| Unlimited | 4,980円 | 無制限 + バッチ取得(1リクエストで最大10件) | サブスクリプションページから申込 |
| Enterprise | お問い合わせ | カスタム | 商務・機能カスタマイズ対応 — お問い合わせ |
※全プラン共通:1リクエスト/秒(TPS=1)。日次リクエストは日本時間(JST)0:00 にリセット。
※上限超過時は HTTP 429 を返却します。
※プランの解約・アップグレードはいつでもサブスクリプションページから可能です。
| ヘッダー | 説明 |
|---|---|
X-RateLimit-Limit | 日次上限 |
X-RateLimit-Remaining | 残りリクエスト数 |
X-RateLimit-Reset | リセット時刻 (UNIX timestamp, JST 00:00) |
JAN コードまたは ASIN で買取価格を検索します。31店舗の買取価格を返却。
| パラメータ | 型 | 説明 |
|---|---|---|
jan_or_asin | string | JAN (7-14桁) または ASIN (B で始まる10桁) |
curl -H "Authorization: Bearer ktx_YOUR_KEY" \
"https://kaitorix.app/open/api/product/4549995649284"
import requests
headers = {"Authorization": "Bearer ktx_YOUR_KEY"}
r = requests.get("https://kaitorix.app/open/api/product/4549995649284", headers=headers)
data = r.json()
print(f"最高買取: {data['max_price']:,}円 ({data['name']})")
const r = await fetch("https://kaitorix.app/open/api/product/4549995649284", {
headers: { "Authorization": "Bearer ktx_YOUR_KEY" }
});
const data = await r.json();
console.log(`最高買取: ${data.max_price}円`);
JAN で検索した場合は jan、ASIN で検索した場合は asin のみが返却されます。
{
"jan": "4549995649284",
"name": "iPhone 17 Pro Max 256GB シルバー MFY84J/A 未開封 SIMフリー",
"max_price": 220000,
"prices": [
{"store": "買取一丁目", "price": 220000, "url": "https://...", "updated": "8分前"},
{"store": "買取商店", "price": 220000, "url": "https://...", "updated": "13分前"},
...
]
}
最大 10 件の JAN/ASIN を 1 リクエストで一括取得します(Unlimited プラン限定)。レート制限は 1 リクエスト = 1 カウント、TPS=1 は他エンドポイント共通。
| パラメータ | 型 | 説明 |
|---|---|---|
jans | string[] | JAN (7-14桁) または ASIN (10桁) の配列。最大 10 件 |
curl -X POST -H "Authorization: Bearer ktx_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jans":["4549995649284","B0DSDB9TKM","4902370553963"]}' \
"https://kaitorix.app/open/api/product/batch"
import requests
headers = {"Authorization": "Bearer ktx_YOUR_KEY"}
payload = {"jans": ["4549995649284", "B0DSDB9TKM", "4902370553963"]}
r = requests.post("https://kaitorix.app/open/api/product/batch",
json=payload, headers=headers)
for item in r.json()["results"]:
if "error" in item:
print(f"NG {item.get('jan') or item.get('asin')}: {item['error']}")
else:
print(f"{item['name']}: 最高 {item['max_price']:,}円")
const r = await fetch("https://kaitorix.app/open/api/product/batch", {
method: "POST",
headers: {
"Authorization": "Bearer ktx_YOUR_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({ jans: ["4549995649284", "B0DSDB9TKM"] })
});
const { results } = await r.json();
results.forEach(item => console.log(item.jan, item.max_price ?? item.error));
存在しない JAN/ASIN は error フィールド付きで返却され、レスポンス全体は 200 で返ります。
{
"count": 3,
"results": [
{
"jan": "4549995649284",
"name": "iPhone 17 Pro Max 256GB シルバー MFY84J/A 未開封 SIMフリー",
"max_price": 220000,
"prices": [ { "store": "買取一丁目", "price": 220000, ... }, ... ]
},
{
"asin": "B0DSDB9TKM",
"jan": "4902370553963",
"name": "トモダチコレクション わくわく生活 -Switch",
"max_price": 6150,
"prices": [ ... ]
},
{ "jan": "4902370553963", "error": "not_found" }
]
}
| HTTP | 条件 |
|---|---|
400 | JSON ボディなし / jans 配列でない / 11 件以上 / 要素が文字列でない |
403 | Unlimited 以外のプラン |
429 | TPS 超過(1リクエスト/秒) |
全モデルの Apple Store 在庫状況 + 買取価格を返却。
curl -H "Authorization: Bearer ktx_YOUR_KEY" \
"https://kaitorix.app/open/api/apple-stock"
r = requests.get("https://kaitorix.app/open/api/apple-stock", headers=headers)
for p in r.json()["products"]:
in_stock = [s for s, v in p["stock"].items() if v]
print(f"{p['model']} {p['color']}: {len(in_stock)}店舗在庫あり")
特定パーツ番号の在庫を取得。パーツ番号は下記参照表を参照。
今日の API 使用状況(使用回数、残り回数、7日間履歴)を取得。
現在のユーザー情報、API Key、プランを表示。
アクティベーションコードでプレミアムプランにアップグレード。
POST /open/api/activate
Content-Type: application/json
{"code": "YOUR_ACTIVATION_CODE"}
API Key を再生成(古いキーは無効化されます)。
/open/api/apple-stock/{part} で使用するパーツ番号一覧です。
読み込み中...
買取・仕入れの情報をリアルタイムで共有・相談できるサーバーです。