Storelift API

01ベースアドレスと認証

ベースは https://storelift.net/v1 です。キーは「設定」→「API」で作成します。表示されるのは一度だけで、ハッシュとしてのみ保存されるため、紛失したキーは復元ではなく再発行になります。

キーは x-api-key として送るか、クライアントが Authorization ヘッダーしか扱えない場合は Bearer トークンとして送ります：

curl -s https://storelift.net/v1/apps \
  -H "x-api-key: sl_live_..."

029 本のエンドポイント

/apps/{id} 以下のエンドポイントは country（us のようなストアフロントコード。既定はアプリの最初のもの）を受け取り、両ストアを計測している場合は platform=ios|android も受け取ります。

033 つの計測状態は境界を越えても保たれる

連携を書く前に読んでおく価値があるのはこの部分です。順位フィールドは数値になり得ますが、数値がないことには 2 つの異なる意味があり、API はそれを区別したまま返します：

• measured: true, rank: 7 — アプリは 7 位で見つかりました。
• measured: true, rank: null — 検索は実行され、読み取った深さまでの結果にアプリはありませんでした。
• measured: false — その日は検索を実行できませんでした。順位については何もわかりません。

{
  "country": "de",
  "platform": "ios",
  "live": true,
  "measuredAt": "2026-09-19T02:14:08.921Z",
  "keywords": [
    { "term": "traumdeutung", "measured": true,  "rank": 7,    "demand": 6, "searchDepth": 200 },
    { "term": "traumsymbole", "measured": true,  "rank": null, "demand": 3, "searchDepth": 200 },
    { "term": "traumtagebuch", "measured": false, "rank": null, "demand": null, "searchDepth": null }
  ]
}

後の 2 つをゼロにまとめると、起きていない急落を描くことになり、その上に築いた平均値はすべて間違ったものになります。コードで 1 つの数値が必要な場合は、measured: false を値ではなく推移の欠測として扱ってください。

04API がしないこと

• 書き込みはしません。エンドポイントはすべて GET で、それ以外は method_not_allowed を返します。API からストアページ、トラッキング中のキーワード、請求に届く経路はありません。
• 要求に応じて計測はしません。エンドポイントが読むのは夜間の実行が集めたデータです。2 回問い合わせても、ストアに 2 回目のクエリが送られることはありません。
• 売上レイヤーは含みません。接続済みアカウント（App Store Connect、Apple Ads、RevenueCat、GA4）はダッシュボードにとどまります。見落としではなく、意図的に引いた線です。
• 履歴はプランに応じて切り詰められます。history と charts はどちらもプランの期間で切れるため、同じキーで一方のエンドポイントからだけ遠くまで遡ることはできません。

05エラー

エラーはすべて error フィールドを持つ JSON です。plan_required は plan も返すため、クライアントは推測せずに、キーがどのプランにあるかを表示できます。

次に読む