ベースアドレスと認証
ベースは https://storelift.net/v1 です。キーは「設定」→「API」で作成します。表示されるのは一度だけで、ハッシュとしてのみ保存されるため、紛失したキーは復元ではなく再発行になります。
キーは x-api-key として送るか、クライアントが Authorization ヘッダーしか扱えない場合は Bearer トークンとして送ります:
curl -s https://storelift.net/v1/apps \
-H "x-api-key: sl_live_..."27 本のエンドポイント
| エンドポイント | 返すもの |
|---|---|
GET /v1/apps | このアカウントがトラッキングしているアプリ。ほかのすべての呼び出しはここから始まり、id はここで得られます。 |
GET | 1 つのアプリと、最新の実行のスナップショット。 |
GET | 1 つのストアフロントでトラッキング中の各キーワードの現在の順位。計測状態と検索した深さ付き。 |
GET | あなたより上位のアプリ。それぞれ、あなたに勝っているキーワードと双方の順位付き。 |
GET | アシスタントがあなたのカテゴリであなたのアプリの名前を挙げるか。保存された推移付き。Pro、Studio または Enterprise が必要です。 |
GET | キーワードごとの順位推移。プランの履歴期間に合わせて返します。 |
GET | ストアが配信しているとおりの自社のストアページ(両プラットフォーム)と、そこで検出した日付付きの変更。 |
GET | 最近のレビューと星の集計、今回の実行で増えた件数、計測している場合は Play 側。/reviews/search はアーカイブ全体をテキスト・星・バージョン・日付で検索し、/reviews/stats は分布、日ごとの推移、バージョン別の内訳を返します。 |
GET | 日付つきの掲載情報の変更(バージョン、スクリーンショット、イベント、フィーチャー、キーワード欄の変更)と、それぞれの前後のキーワード順位の動き。 |
GET | 国ごとのエディトリアルカード、App 内イベント、Apple の「こちらもおすすめ」棚。フィーチャーと新しいイベントの日付つき履歴も。 |
GET | アプリのジャンルとストアフロントでのトップチャート順位と、その推移。 |
GET | 接続したソースから得たアプリの売上とダウンロード数:App Store Connect のユニット数、Google Play のインストール数、RevenueCat の MRR、サブスクリプションとトライアル。何も接続していない場合は connected:false。スコープは revenue:read。 |
GET | RevenueCat / Adapty の Webhook から得たサブスクリプションイベント数。日別、国別、月次コホート別。スコープは revenue:read。 |
GET | App Store のインプレッション → プロダクトページの閲覧 → ダウンロード。App Store Connect のアナリティクスから、今日の値と日ごとの履歴を返します。スコープは revenue:read。 |
GET | RevenueCat / Adapty の Webhook から、製品と国ごとの現在の価格、固定価格の期間ごとのトライアル・有料開始・収益、そしてオファーコード。スコープ revenue:read。 |
GET | アプリを宣伝している Apple Ads キャンペーン(App Store id で照合):費用、タップ数、インストール数、予算、ステータスに加え、上位のキーワードと検索語句。スコープは ads:read。 |
/apps/{id} 以下のエンドポイントは country(us のようなストアフロントコード。既定はアプリの最初のもの)を受け取り、両ストアを計測している場合は platform=ios|android も受け取ります。
3 つの計測状態は境界を越えても保たれる
連携を書く前に読んでおく価値があるのはこの部分です。順位フィールドは数値になり得ますが、数値がないことには 2 つの異なる意味があり、API はそれを区別したまま返します:
measured: true,rank: 7— アプリは 7 位で見つかりました。measured: true,rank: null— 検索は実行され、searchDepthまでの結果にアプリはありませんでした。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 を値ではなく推移の欠測として扱ってください。
アカウント、使用量、検索
キー自体とアカウント自身の記録を扱うエンドポイントが 4 本あります。最初の 2 本はクレジットを消費しないため、スクリプトは開始前に、何を読めるか、残りがどれだけあるかを確認できます。search と fetch は、ChatGPT がディープリサーチ用コネクタに求める形に沿っています。クエリを送ると id が返り、id を送るとレコードが返ります。
| エンドポイント | 返すもの |
|---|---|
GET /v1/account | キーの持ち主:プラン、認証方式、スコープ、読み取れるアプリ、クレジット残高。0 クレジット。 |
GET /v1/usage | すべてのクォータの使用量 / 上限 / リセット時刻、今日の Hive 利用枠、秒あたりのレート。0 クレジット。 |
GET | 自分のアプリ、トラッキング中のキーワード、競合を検索し、/v1/fetch 用の id を返します(ChatGPT ディープリサーチの形)。 |
GET | search の id に対応する完全なレコード:アプリカード、履歴付きのキーワード 1 つ、またはあなたに勝っているキーワード付きの競合 1 つ。 |
Hive:あらゆるアプリ、あらゆる市場
上のエンドポイントは、あなたがトラッキングしているアプリを読みます。Hive エンドポイントは、ネットワーク全体が計測しているもの(チャート、任意のアプリの日次計測、キーワードの検索結果リスト、競合のキーワード、任意のアプリの売上とダウンロード数)を読みます。キーに専用のスコープが必要で、1 回あたりのクレジットも多めです。各プランには Hive の 1 日の利用枠もあり、1 か月分のクレジットが 1 か月もつように配分されます。
| エンドポイント | 返すもの | スコープ |
|---|---|---|
GET | ストアフロントの Top Free、Top Grossing、iPad のリスト(100 位まで)。最新日時点。 | hive:read |
GET | 任意のアプリの最新の日次計測:評価数、評価、バージョン、価格、星の分布、カテゴリバッジに加え、対応言語、今後の App 内イベント、プロモーションテキスト、おすすめのアプリ内課金。 | hive:read |
GET | あるキーワードでどのアプリが順位を得たかを日ごとに(1 回の呼び出しで 1,000 行)。 | hive:read |
GET | 競合が順位を得ているキーワード。ダッシュボードと同じプライバシーフィルターと月間スパイ枠が適用されます。 | hive:spy |
GET | 任意の App Store アプリの全世界の月間売上とダウンロード数(初回の読み取り中は 202)。 | hive:estimate |
GET | 1 つのトップチャートで上昇したアプリ、下落したアプリ、新たに入ったアプリ、外れたアプリを、N 日前の同じチャートと比べて返します。差分はすべて計測済みの 2 日の間で取り、回答にはその両日が明記されます。 | hive:read |
GET | トップチャートに初めて登場したアプリを新しい順に返します。回答にはその期間のうちインデックスがカバーしている日数が含まれるため、初登場日はすべてインデックス済みの日です。 | hive:read |
GET | 計測しているチャート全体からアプリを探します。カテゴリ、ストアフロント、チャート(Top Grossing、Top Free、Top Paid、Top iPad)、順位帯、初登場日、名前、パブリッシャーで絞り込めます。各行にそのアプリの売上とダウンロード数が付きます。 | hive:read |
GET | 最大 5 つのアプリを並べたキーワードギャップ:それぞれがどのキーワードで順位を得ていて、どれを取りこぼしているか。Hive Explorer の機能です。spy と同じプライバシーフィルターを使い、各アプリが自身の計測状態を持つため、表のどのセルも計測された事実です。 | hive:spy |
GET | Hive が確認した 1 つのパブリッシャーの全アプリと、それぞれが初めてチャート入りした日。 | hive:read |
GET | 名前、開発元、ストアのリンク、App Store ID、パッケージ名から任意のアプリの ID。名前はそのストアの App Store 検索で探します。 | hive:read |
GET | 任意のアプリに対するストアの類似アプリ棚。棚の順番で、各アプリのカテゴリと名前、読み取り日つき。 | hive:read |
GET | 任意のアプリの 1 ストアでの最新レビューと星の分布。投稿者名は含みません。 | hive:read |
ここで扱うデータは個人に結びつきません。レビューは投稿者名を除いて扱い、競合のキーワードは、ほかの 2 つ以上のアカウントかあなた自身がトラッキングしている場合に表示されます。
キーなしで試す
すべてのパスは /v1/sandbox/ 以下にもあり、キーは一切不要です。形は同じで、2 つのアプリからなる固定データセットを使い、日付は前日に合わせて進みます。レスポンスには x-sandbox: true が付きます。CI 用には「設定」でテストキー(sl_test_)を作成できます。テストキーはサンドボックスからだけ応答し、クレジットを消費せず、すべてのプランで使えるため、万一漏れても見えるのはサンドボックスのデータだけです。
curl -s https://storelift.net/v1/sandbox/apps
curl -s 'https://storelift.net/v1/sandbox/hive/keywords/sleep%20sounds/ranks?country=us&days=3&top=10'書き込みとスコープのしくみ
- 書き込みはすべて先にプレビューされます。読み取りは
GETです。POST /v1/actionsは変更前後の差分、クレジットのコスト、1 回限りのトークンを返し、この段階ではデータはそのままです。適用するのはPOST /v1/actions/confirmです。トークンはアクション、引数、プレビュー時点の対象の状態に結びついているため、その間に対象が変わっていれば、confirm は新しい差分とともにconfirm_token_mismatchを返し、データはそのまま残ります。アクションの対象は、キーワード、競合、アプリ、共有リンク、レビューへの返信(Pro 以上)、そして Studio では編集可能な App Store バージョンのストア掲載テキストと Apple Ads の一時停止・再開・1 日の予算です。全リストはリファレンスにあります。 - 書き込みスコープはオプトインです。書き込みにはそれぞれのスコープ(
track:write、reports:write、reviews:write、ads:write、listing:write)が必要で、キーの作成時にはどれもチェックが外れた状態で始まります。テストキーはサンドボックスから応答し、あなたのデータはそのまま保たれます。請求はアカウント設定で管理します。 - 観測の日付と状態を確認してください。レスポンスには、保存された計測、確認済みのデータ不在、処理待ち、エラーのいずれかが含まれる場合があります。再リクエストしても過去の観測日付は新しくなりません。
- 売上レイヤーは専用のスコープで守られています。10 本のグロース系エンドポイント(
revenue、subscriptions、funnel、pricing、change-impact、campaigns、ads-keywords、ads-search-terms、ads-commands、search-popularity)は、機密性の高いrevenue:read/ads:readスコープ付きで作成したキーに応答するため、売上データを開くかどうかはあなたが選べます。GA4 はダッシュボードで扱います。 - 履歴はプランに従います。
historyとchartsはどちらもプランの期間を使うため、同じキーならどちらのエンドポイントからでも同じところまで遡れます。
エラー
| ステータス | error | 発生するとき |
|---|---|---|
| 401 | missing_api_key | リクエストにキーがありません。 |
| 401 | invalid_api_key | キーが不明か、取り消されています。 |
| 401 | account_deleted | キーに紐づくアカウントが削除されています。 |
| 403 | plan_required | プランに API アクセスが含まれていません。レスポンスには現在のプランが入ります。 |
| 405 | method_not_allowed | 読み取りは GET です。POST は /v1/actions、/v1、/v1 で受け付けます(下書きは本文で送ります)。 |
| 400 | unknown_action | アクション名がカタログにありません。レスポンスには利用できるアクションの一覧が入ります。 |
| 400 | invalid_arguments | 引数が欠けているか、形式が正しくありません。レスポンスにはそのフィールド名が入ります。 |
| 409 | confirm_token_expired | トークンの発行から 10 分を過ぎています。もう一度プレビューしてください。 |
| 409 | confirm_token_mismatch | プレビュー後に対象が変わりました。レスポンスには新しい差分が入ります。 |
| 403 | write_limit_reached | 書き込みがガードレール(予算の変更幅、1 日のアクション数)の範囲外です。 |
| 403 | test_key_read_only | テストキーで行えるのは読み取りです。 |
| 404 | job_not_found | このワークスペースにその id のジョブはありません。 |
| 403 | workspace_suspended | ワークスペースが停止されています。理由はサポートがお伝えします。 |
| 403 | ip_list_required | このワークスペースでは、すべてのキーに IP 許可リストが必要です。 |
| 404 | not_found | そのアプリ id はこのアカウントにありません。 |
| 404 | unknown_endpoint | /v1 以下にそのパスはありません。 |
| 402 | credits_exhausted | 今月のクレジットを使い切りました。レスポンスにはクレジットパックへのリンクが入ります。 |
| 429 | rate_limited | このキーのリクエストが多すぎます。Retry-After の秒数だけ待ってください。 |
| 429 | daily_hive_limit | プランの今日の Hive 利用枠を使い切りました。00:00 UTC にリセットされます。 |
| 404 | not_measured | 指定されたアプリ、キーワード、範囲について、検証済みの観測データがありません。欠測はゼロを意味しません。リクエストのパラメーターと、利用可能な操作を説明するリンク先のドキュメントを確認してください。 |
| 400 | bad_query | /v1/search には 1〜120 文字の q が必要です。 |
| 400 | bad_id | /v1/fetch には /v1/search が返したとおりの id が必要です。 |
| 403 | asc_required | update_listing には接続済みの App Store Connect キーが必要です。 |
| 403 | asc_role | メタデータを編集するには、App Store Connect キーに Admin または App Manager のロールが必要です。 |
| 409 | no_editable_version | 編集可能な App Store バージョンがありません。レスポンスには現在のバージョンの状態が一覧で入ります。 |
| 404 | locale_not_found | そのストアフロント言語はバージョンにありません。レスポンスにはバージョンにある言語の一覧が入ります。 |
| 409 | changed_since_preview | プレビュー後に App Store Connect でストア掲載情報が変更されました。ストア掲載情報はそのまま残っています。 |
| 422 | asc_rejected | App Store Connect が変更を拒否しました。App Store Connect 自身のメッセージは detail に入ります。 |
| 409 | in_progress | 同じ対象への書き込みがまだ実行中です。 |
| 403 | ip_not_allowed | キーに IP 許可リストが設定されており、このリクエストはリスト外の場所から送られました。 |
| 401 | key_leaked | キーが公開リポジトリで見つかったため、自動的に取り消されました。新しいキーを作成してください。 |
エラーはすべて error フィールドを持つ JSON です。plan_required は plan も返すため、クライアントは推測せずに、キーがどのプランにあるかを表示できます。
よくある質問
レート制限はありますか?
はい、キーごとにあります。プランに応じた秒あたりのリクエスト数(超えると Retry-After 付きの 429)、x-credits-* ヘッダーに表示される月間クレジット枠、そして Hive の 1 日の利用枠です。各呼び出しはキーの使用カウンタも更新するため、古いキーがまだ使われているかを設定画面で確認できます。
無料プランで使えますか?
API 用の本番キーとリモート MCP サーバーは Pro から使えます。キー不要のサンドボックスとテストキーはすべてのプランで使えます。このサイトの無料ツールはアカウントなしで使え、無料プランでも 1 つのアプリを毎日計測します。
API と MCP サーバー、どちらを使うべきですか?
スクリプトには API が向いています。形が固定で、1 回の呼び出しで済み、間にモデルが入りません。アシスタントには MCP サーバーが向いています。ツールが自身の説明を持っているので、あなたが連携を書かなくても正しい呼び出しを選べます。どちらも同じ計測データを扱い、どちらも同じ「プレビューしてから確定」の手順で書き込みます。
自分のアプリで確かめる
ストアのリンクを貼り付けて、キーワードを追加するだけ。順位、上位のアプリ、需要を毎日計測します。
無料プラン:1 アプリ、2 つのストアフロントでそれぞれ 10 キーワード、14 日分の履歴。カード不要、期限なし。Pro は月額 $29。
無料で始める →
