API ドキュメント

認証

Open API を利用するには認証が必要です。2つの方法があります:

1. API Key (プログラム向け)

マイページでAPI Keyを取得し、リクエストに含めます。

Authorization: Bearer ktx_your_api_key_here

またはクエリパラメータ:

GET /open/api/product/4549995649284?key=ktx_your_api_key_here

2. ブラウザセッション (Web向け)

kaitorix.app にGoogleログイン済みの場合、Cookieで自動認証されます。

料金プラン・レート制限

※全プラン共通：1リクエスト/秒（TPS=1）。日次リクエストは日本時間（JST）0:00 にリセット。
※上限超過時は HTTP 429 を返却します。
※プランの解約・アップグレードはいつでもサブスクリプションページから可能です。

レスポンスヘッダー

エンドポイント

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": "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分前"},
    ...
  ]
}

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)}店舗在庫あり")

POST /open/api/activate
Content-Type: application/json

{"code": "YOUR_ACTIVATION_CODE"}

エラーコード

200 OK

正常なレスポンス

400 Bad Request

無効なパラメータ（JAN/ASIN 形式エラー等）

401 Unauthorized

認証が必要（ログインまたは API Key 指定）

404 Not Found

商品またはパーツ番号が見つかりません

429 Too Many Requests

日次リクエスト上限超過

500 Internal Server Error

サーバーエラー

Apple パーツ番号参照表

/open/api/apple-stock/{part} で使用するパーツ番号一覧です。