# API 参考

> https://storelift.net/zh/docs/api/

一个基础 URL，一个密钥，收发都是 JSON。下面每个接口同时也是一个同名的 MCP 工具。 OpenAPI 3.1: https://storelift.net/openapi.json

## 基础 URL

`https://storelift.net/v1`

下面的每个路径都相对于它。读取用 `GET`，只有 `/actions` 用 `POST`。

## 身份验证

在 `Authorization: Bearer <key>` 或 `x-api-key` 中发送密钥。在“设置 › API”里创建密钥；每个密钥都带有权限范围，并可选设置 IP 白名单、应用列表和每月额度预算。达到预算的密钥会一直返回 `402 key_budget_reached`，直到进入下个月；其他密钥照常工作。

用于 REST API 的正式密钥（`sl_live_`）在 Pro 及以上套餐提供，任何套餐购买额度包后也可使用。Free 套餐包含一个仅适用于 MCP 服务器的正式密钥。测试密钥（`sl_test_`）在任何套餐下都返回沙盒数据。AI 助手在任何套餐下都通过 [MCP 服务器](https://storelift.net/zh/mcp-server/)以 OAuth 登录。

## 额度与限制

每次调用消耗的额度都标在该接口上；`/account` 和 `/usage` 消耗 0 额度，写入的预览也消耗 0 额度。每个响应都带有 `x-credits-used`、`x-credits-limit`、`x-credits-remaining` 和 `x-credits-reset`。

每秒请求数按套餐设定；超过后会收到 `429 rate_limited` 和 `retry-after`。Hive 接口需要购买的 API 额度或 Hive Explorer 才能开通，并且还计入每日上限：使用额度包的额度每天 500 次调用，使用 Hive Explorer 每天 10,000 次。[每次调用的额度](https://storelift.net/zh/hive/api/)

## 沙盒

`https://storelift.net/v1/sandbox` 可以响应下面每个带示例响应的读取接口，不需要密钥，也不消耗额度。数据是固定且带日期的，所以测试结果保持稳定。

测试密钥（`sl_test_`）在正式的基础 URL 上返回同样的数据，并且从不写入。

## 如何读排名

排名有三种状态，并且始终区分开来：`measured: false` 表示这个查询当天没有测量，`rank: null` 表示已经测量、但应用不在读取到的结果之内，如果是数字，它就是排名。

## 错误

每个错误的响应体都相同：`{ "error": "<code>", "message": "…", "docs": "…" }`。`error` 是稳定的；请根据它做分支，而不是根据 `message`。有些代码还会附带 `scope`、`field` 或 `limit` 这样的字段。[全部错误代码](https://storelift.net/zh/docs/api/errors/)

## 完整示例

三项工作，从第一次调用到你最终保留的结果。每条命令都在沙盒上运行，所以不消耗额度，也不改动任何东西，每个响应都是沙盒针对它返回的内容。

用你自己的密钥时，路径相同，只是去掉 `/sandbox`，每次调用消耗该接口上标明的额度。测试密钥（`sl_test_`）在那里同样返回沙盒数据，消耗 0 额度。

### 把本周的关键词排名加进报告

读取一款应用在一个店面的关键词，保留成一行。每周运行一次，这些行就连成一条趋势。

权限范围: `apps:read` · 额度: 2 · 在沙盒中或使用测试密钥时为 0 · 套餐: 沙盒、测试密钥: 所有套餐 · 正式密钥: Pro 及以上 · 起始版本: API 1.5.0

1. 找到应用 ID。

```sh
curl "https://storelift.net/v1/sandbox/apps"
```

响应:

```json
{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "icon": null,
      "iosId": "1000000001",
      "androidPkg": "net.storelift.sandbox.lumen",
      "bundleId": "net.storelift.sandbox.lumen",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ],
      "keywordsByCountry": {
        "us": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "gb": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "de": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "icon": null,
      "iosId": "1000000002",
      "androidPkg": null,
      "bundleId": "net.storelift.sandbox.quill",
      "countries": [
        "us",
        "jp"
      ],
      "keywords": [
        "notes",
        "markdown notes",
        "journal"
      ],
      "keywordsByCountry": {
        "us": [
          "notes",
          "markdown notes",
          "journal"
        ],
        "jp": [
          "notes",
          "markdown notes",
          "journal"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    }
  ]
}
```

2. 读取该应用在这个店面追踪的全部关键词。

```sh
curl "https://storelift.net/v1/sandbox/apps/sbx-lumen/keywords?country=us"
```

响应 (keywords: 共 8 行，显示 2 行):

```json
{
  "country": "us",
  "platform": "ios",
  "live": true,
  "measuredAt": "2026-09-27T02:10:00.000Z",
  "keywords": [
    {
      "term": "sleep sounds",
      "measured": true,
      "rank": null,
      "demand": 73,
      "hintCount": 6,
      "popularity": 73,
      "popularitySource": "p2",
      "popularityWeek": null,
      "popularityNone": false,
      "difficulty": 70,
      "difficultyBand": "brutal",
      "difficultyNone": false,
      "popularityMeasuring": false,
      "difficultyMeasuring": false,
      "measuring": false,
      "searchDepth": 200
    },
    {
      "term": "white noise",
      "measured": true,
      "rank": 57,
      "demand": 37,
      "hintCount": 4,
      "popularity": 37,
      "popularitySource": "p2",
      "popularityWeek": null,
      "popularityNone": false,
      "difficulty": 70,
      "difficultyBand": "brutal",
      "difficultyNone": false,
      "popularityMeasuring": false,
      "difficultyMeasuring": false,
      "measuring": false,
      "searchDepth": 200
    }
  ]
}
```

把响应汇总进你保存的那一行。`measured: true` 且 `rank: null` 的关键词表示已经测量、但应用不在结果中；它要和没有测量的关键词分开计数。

```js
function weeklyRow(body) {
  const ranked = body.keywords.filter((k) => k.measured && k.rank !== null);
  const best = ranked.reduce((a, b) => (a && a.rank <= b.rank ? a : b), null);
  return {
    measuredAt: body.measuredAt,
    country: body.country,
    platform: body.platform,
    keywords: body.keywords.length,
    ranked: ranked.length,
    absent: body.keywords.filter((k) => k.measured && k.rank === null).length,
    notMeasured: body.keywords.filter((k) => !k.measured).length,
    best: best && { term: best.term, rank: best.rank },
  };
}
```

结果:

```json
{
  "measuredAt": "2026-09-27T02:10:00.000Z",
  "country": "us",
  "platform": "ios",
  "keywords": 8,
  "ranked": 6,
  "absent": 2,
  "notMeasured": 0,
  "best": {
    "term": "nature sounds",
    "rank": 29
  }
}
```

工作区里没有的应用 ID 会返回 `404`：

```sh
curl "https://storelift.net/v1/sandbox/apps/sbx-unknown/keywords?country=us"
```

```json
{
  "error": "not_found",
  "message": "No such app in this workspace.",
  "docs": "https://storelift.net/docs/api/errors#not_found"
}
```

### 问问谁排在你前面

同样的数据，通过 [MCP 服务器](https://storelift.net/zh/mcp-server/)获取：助手会发出两次工具调用。要手动发送，就把测试密钥放进 `STORELIFT_TEST_KEY`。

权限范围: `apps:read` · 额度: 2 · 使用测试密钥时为 0 · 套餐: 测试密钥、OAuth: 所有套餐 · 正式密钥: 所有套餐 · 起始版本: API 1.5.0 · 工具见于 storelift-mcp 1.1.1

1. `list_apps` 返回应用 ID。

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_apps","arguments":{}}}'
```

响应:

```json
{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "icon": null,
      "iosId": "1000000001",
      "androidPkg": "net.storelift.sandbox.lumen",
      "bundleId": "net.storelift.sandbox.lumen",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ],
      "keywordsByCountry": {
        "us": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "gb": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ],
        "de": [
          "sleep sounds",
          "white noise",
          "rain sounds"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "icon": null,
      "iosId": "1000000002",
      "androidPkg": null,
      "bundleId": "net.storelift.sandbox.quill",
      "countries": [
        "us",
        "jp"
      ],
      "keywords": [
        "notes",
        "markdown notes",
        "journal"
      ],
      "keywordsByCountry": {
        "us": [
          "notes",
          "markdown notes",
          "journal"
        ],
        "jp": [
          "notes",
          "markdown notes",
          "journal"
        ]
      },
      "manualRivals": null,
      "keywordTags": null,
      "buriedKeywords": null,
      "goal": null,
      "tasksDone": null
    }
  ]
}
```

2. `get_rivals` 逐个关键词返回排在它前面的应用。

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_rivals","arguments":{"appId":"sbx-lumen","country":"us"}}}'
```

响应 (rivals: 共 3 行，显示 2 行):

```json
{
  "country": "us",
  "platform": "ios",
  "rivals": [
    {
      "id": "1000000101",
      "name": "Calm Rain",
      "ratings": 57046,
      "terms": [
        {
          "term": "sleep sounds",
          "theirRank": 1,
          "ourRank": null
        },
        {
          "term": "white noise",
          "theirRank": 1,
          "ourRank": 57
        }
      ]
    },
    {
      "id": "1000000102",
      "name": "Noisli",
      "ratings": 16114,
      "terms": [
        {
          "term": "sleep sounds",
          "theirRank": 2,
          "ourRank": null
        },
        {
          "term": "white noise",
          "theirRank": 2,
          "ourRank": 57
        }
      ]
    }
  ]
}
```

逐个竞品来看，响应说明了什么。`ourRank: null` 表示应用没有出现在这个关键词的结果里。

```js
function rivalsAhead(body) {
  return body.rivals.map((r) => ({
    name: r.name,
    ratings: r.ratings,
    aheadOn: r.terms.length,
    absentOn: r.terms.filter((t) => t.ourRank === null).length,
  }));
}
```

结果:

```json
[
  {
    "name": "Calm Rain",
    "ratings": 57046,
    "aheadOn": 8,
    "absentOn": 2
  },
  {
    "name": "Noisli",
    "ratings": 16114,
    "aheadOn": 8,
    "absentOn": 2
  },
  {
    "name": "Deep Sleep Tones",
    "ratings": 64683,
    "aheadOn": 8,
    "absentOn": 2
  }
]
```

工作区里没有的应用 ID，会以助手能读懂的工具错误返回，而不是一次失败的请求：

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":9,"method":"tools/call","params":{"name":"get_rivals","arguments":{"appId":"sbx-unknown","country":"us"}}}'
```

```text
ERROR: No such app in this workspace.
```

### 通过 HTTP 或 MCP 查看一个凭据能读取什么

任何集成的第一次调用：哪个套餐、哪些权限范围、哪些应用，以及还剩多少额度。`GET /account` 和 `whoami` 工具返回相同的响应体，两者都不消耗额度。

权限范围: 无 · 额度: 0 · 套餐: 沙盒、测试密钥、OAuth: 所有套餐 · 正式密钥: Pro 及以上 · 起始版本: API 1.5.0 · 工具见于 storelift-mcp 1.5.0

1. 通过 HTTP。

```sh
curl "https://storelift.net/v1/sandbox/account"
```

响应:

```json
{
  "plan": "studio",
  "auth": "test_key",
  "scopes": [
    "apps:read",
    "reviews:read",
    "ai:read",
    "revenue:read",
    "hive:read",
    "hive:spy",
    "hive:estimate",
    "ads:read"
  ],
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ]
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "countries": [
        "us",
        "jp"
      ]
    }
  ],
  "appRestriction": false,
  "credits": {
    "used": 0,
    "limit": 50000,
    "resetsAt": null
  },
  "hive": {
    "perDay": 10000
  },
  "ratePerSecond": 10,
  "docs": "https://storelift.net/guide/storelift-api/"
}
```

2. 同样的回答，以工具调用的形式。

```sh
curl "https://storelift.net/mcp" \
  -H "Authorization: Bearer $STORELIFT_TEST_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'
```

响应:

```json
{
  "plan": "studio",
  "auth": "test_key",
  "scopes": [
    "apps:read",
    "reviews:read",
    "ai:read",
    "revenue:read",
    "hive:read",
    "hive:spy",
    "hive:estimate",
    "ads:read"
  ],
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ]
    },
    {
      "id": "sbx-quill",
      "name": "Quill Notes",
      "countries": [
        "us",
        "jp"
      ]
    }
  ],
  "appRestriction": false,
  "credits": {
    "used": 0,
    "limit": 50000,
    "resetsAt": null
  },
  "hive": {
    "perDay": 10000
  },
  "ratePerSecond": 10,
  "docs": "https://storelift.net/guide/storelift-api/"
}
```

发起调用之前先检查它需要的权限范围，批量调用之前先读取余额。

```js
function allowance(body) {
  return {
    plan: body.plan,
    auth: body.auth,
    scopes: body.scopes,
    apps: body.apps.map((a) => a.id),
    creditsLeft: body.credits.limit - body.credits.used,
    ratePerSecond: body.ratePerSecond,
  };
}
```

结果:

```json
{
  "plan": "studio",
  "auth": "test_key",
  "scopes": [
    "apps:read",
    "reviews:read",
    "ai:read",
    "revenue:read",
    "hive:read",
    "hive:spy",
    "hive:estimate",
    "ads:read"
  ],
  "apps": [
    "sbx-lumen",
    "sbx-quill"
  ],
  "creditsLeft": 50000,
  "ratePerSecond": 10
}
```

没有凭据时，MCP 端点返回 `401` 和一个 JSON-RPC 错误，支持 MCP 授权的客户端会由此开始 OAuth 登录：

```sh
curl "https://storelift.net/mcp" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":9,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'
```

```json
{
  "jsonrpc": "2.0",
  "id": 9,
  "error": {
    "code": -32001,
    "message": "No credentials were sent. Sign in with OAuth on any plan, or add Authorization: Bearer <your Storelift API key>. Live keys require Pro, Studio, Enterprise, or an eligible Free account with purchased API credits or active Explorer. Tool access still depends on plan, scopes and credits. Generate a key at Storelift → Settings → API keys."
  }
}
```

## 通用参数

在接受这些参数的每个接口上，它们的含义都相同；每个接口会列出自己接受的参数。

- `appId` (path, string) — app id from list_apps
- `country` (query, string) — country code, e.g. tr, us (defaults to the app's first country)
- `platform` (query, ios | android) — defaults to ios
- `country` (query, string) — storefront code, e.g. us (defaults to us)

## [账号](https://storelift.net/zh/docs/api/account/)

密钥自身的套餐、权限范围和用量，账号搜索，以及提醒动态。读取套餐和用量消耗 0 额度。

- [`GET /alerts`](https://storelift.net/zh/docs/api/account/#list_alerts) — The alert feed of this workspace — rank drops and rises, keywords entering or leaving the results, rivals… (1)
- [`GET /portfolio`](https://storelift.net/zh/docs/api/account/#get_portfolio_overview) — Today across every app in the workspace, one row per app: live users, users and new users, ad revenue,… (2)
- [`GET /account`](https://storelift.net/zh/docs/api/account/#whoami) — Who this key or session belongs to: plan, how it authenticated, the scopes it carries, the apps it may… (0)
- [`GET /usage`](https://storelift.net/zh/docs/api/account/#get_usage) — Every quota of the workspace with what is used and the reset time: tracked keywords, apps, discovery, AI… (0)
- [`GET /search`](https://storelift.net/zh/docs/api/account/#search) — Search this account's own records — app names and store ids, tracked keywords, and the rival apps that… (1)
- [`GET /fetch`](https://storelift.net/zh/docs/api/account/#fetch) — The full record behind one id from search: an app card, one tracked keyword with its current state and… (1)

## [你的应用](https://storelift.net/zh/docs/api/apps/)

这个工作区追踪的应用：排名、竞品、评论、商店页面、页面变更时间线、编辑推荐、榜单和页面检查。

- [`GET /apps`](https://storelift.net/zh/docs/api/apps/#list_apps) — List the apps tracked in this Storelift account (id, name, countries, keywords) (1)
- [`GET /apps/{appId}/keywords`](https://storelift.net/zh/docs/api/apps/#get_keywords) — Keyword ranks for one app in one App Store / Google Play country (1)
- [`GET /apps/{appId}/rivals`](https://storelift.net/zh/docs/api/apps/#get_rivals) — Apps that rank ABOVE this app in search (1)
- [`GET /apps/{appId}/ai`](https://storelift.net/zh/docs/api/apps/#get_ai_visibility) — App mentions in a dated sample of AI engine answers; this does not reproduce what ChatGPT, Claude or… (1)
- [`GET /apps/{appId}/ai-check`](https://storelift.net/zh/docs/api/apps/#run_ai_visibility_check) — Start an AI visibility sample for one app in one country, with the engines available for the run (1)
- [`GET /apps/{appId}/history`](https://storelift.net/zh/docs/api/apps/#get_history) — Keyword rank history for one country (1)
- [`GET /apps/{appId}/page`](https://storelift.net/zh/docs/api/apps/#get_store_page) — The app's own store listing signals for one country (name and subtitle are not included): version, in-app… (1)
- [`GET /apps/{appId}/reviews`](https://storelift.net/zh/docs/api/apps/#get_reviews) — Recent reviews for one country: `list` holds the App Store reviews, `android` the Google Play reviews (a… (1)
- [`GET /apps/{appId}/charts`](https://storelift.net/zh/docs/api/apps/#get_charts) — App Store chart position for one country: current ranks per list (free / paid / grossing, overall and in… (1)
- [`GET /apps/{appId}/reviews/search`](https://storelift.net/zh/docs/api/apps/#search_reviews) — Search one app's reviews in one storefront by text, star rating, app version and date range, newest first… (1)
- [`GET /apps/{appId}/reviews/stats`](https://storelift.net/zh/docs/api/apps/#get_review_stats) — Star-rating distribution, average and share of 1–2 star reviews for one app in one storefront, plus a… (1)
- [`GET /apps/{appId}/reviews/summary`](https://storelift.net/zh/docs/api/apps/#summarize_reviews) — Review AI for one app in one storefront: a summary of the recent reviews and the themes in them —… (1)
- [`GET /apps/{appId}/reviews/reply-draft`](https://storelift.net/zh/docs/api/apps/#draft_review_reply) — A developer reply draft for one review, in the storefront's language (1)
- [`GET /apps/{appId}/timeline`](https://storelift.net/zh/docs/api/apps/#get_listing_timeline) — Dated changes to one app's listing — new version, screenshots, in-app events, featuring from the store… (1)
- [`GET /apps/{appId}/today`](https://storelift.net/zh/docs/api/apps/#get_today) — One app's day in one answer — the Today screen: purchases, trials and renewals from the connected sources,… (1)
- [`GET /apps/{appId}/competition`](https://storelift.net/zh/docs/api/apps/#get_keyword_competition) — How many apps compete on each keyword in one storefront, returned for terms seen on two or more apps (1)
- [`GET /apps/{appId}/rivals/{rivalId}`](https://storelift.net/zh/docs/api/apps/#get_rival_detail) — One rival of your app in one storefront: its name, rating and rating count with a 90-day history of them… (1)
- [`GET /apps/{appId}/rivals/{rivalId}/adnetworks`](https://storelift.net/zh/docs/api/apps/#get_rival_ad_networks) — How a rival monetises with ads: the ad networks it works with, each marked DIRECT or RESELLER (1)
- [`GET /apps/{appId}/rivals/{rivalId}/market`](https://storelift.net/zh/docs/api/apps/#get_rival_market) — A rival's market in one storefront: on Google Play the exact install count and in-app purchase price… (1)
- [`GET /apps/{appId}/storefront-audit`](https://storelift.net/zh/docs/api/apps/#get_storefront_audit) — Your iOS listing in every App Store storefront: where the app is sold, which storefronts serve the… (1)
- [`GET /apps/{appId}/suggest`](https://storelift.net/zh/docs/api/apps/#suggest_keywords) — New keyword ideas for one app in one storefront, written in that storefront's search language: terms of… (1)
- [`POST /apps/{appId}/validate-listing`](https://storelift.net/zh/docs/api/apps/#validate_listing) — Check a draft App Store listing before it goes to App Store Connect (1)
- [`GET /apps/{appId}/draft`](https://storelift.net/zh/docs/api/apps/#draft_listing) — A listing draft — title, subtitle, promotional text and description — built from the keywords measured for… (1)
- [`GET /apps/{appId}/localize`](https://storelift.net/zh/docs/api/apps/#localize_listing) — Write the full App Store listing for a new locale — name, subtitle, keyword field and description — from… (1)
- [`GET /apps/{appId}/shot-text`](https://storelift.net/zh/docs/api/apps/#get_screenshot_text) — The caption text on your first four App Store screenshots in one storefront (1)
- [`GET /apps/{appId}/chart-movers`](https://storelift.net/zh/docs/api/apps/#get_chart_movers) — Who moved in the app's own category chart: risers and fallers (3+ places), new entrants and drop-outs,… (1)
- [`GET /apps/{appId}/featuring`](https://storelift.net/zh/docs/api/apps/#get_featuring) — Where Apple shows the app today, per country: editorial cards (dedicated: true when the story is about… (1)
- [`GET /apps/{appId}`](https://storelift.net/zh/docs/api/apps/#get_app) — One tracked app with its platform ids, countries, tracked keywords per country and the latest measurement… (1)
- [`GET /apps/{appId}/weekly-plan`](https://storelift.net/zh/docs/api/apps/#get_weekly_plan) — This week's listing suggestions for the app — the same list as the dashboard's "This week" card, best first (1)

## [收入与 Apple Ads](https://storelift.net/zh/docs/api/growth/)

每款应用已连接的数据来源：收入、订阅事件、App Store 转化漏斗、价格和优惠代码、一次改动前后的对比，以及 Apple Ads 的广告系列、关键词、搜索词和命令。权限范围为 revenue:read 和 ads:read。

- [`GET /apps/{appId}/revenue`](https://storelift.net/zh/docs/api/growth/#get_revenue) — Revenue and downloads for one app from the sources the user connected: App Store Connect daily units per… (1)
- [`GET /apps/{appId}/subscriptions`](https://storelift.net/zh/docs/api/growth/#get_subscription_events) — Subscription event counts for one app from the RevenueCat / Adapty webhook: per day and per country —… (1)
- [`GET /apps/{appId}/funnel`](https://storelift.net/zh/docs/api/growth/#get_store_funnel) — The App Store conversion funnel for one app from App Store Connect analytics: impressions → product page… (1)
- [`GET /apps/{appId}/campaigns`](https://storelift.net/zh/docs/api/growth/#get_ads_campaigns) — Apple Ads campaigns that promote one app (matched by the app's App Store id, not by name): spend,… (1)
- [`GET /apps/{appId}/ads-keywords`](https://storelift.net/zh/docs/api/growth/#get_ads_keywords) — Every Apple Ads keyword bought for one app across its campaigns (last 28 days), by spend: bid, match type,… (1)
- [`GET /apps/{appId}/ads-search-terms`](https://storelift.net/zh/docs/api/growth/#get_ads_search_terms) — The searches people actually typed that triggered the app's Apple Ads (last 28 days), by spend: the search… (1)
- [`GET /apps/{appId}/ads-commands`](https://storelift.net/zh/docs/api/growth/#get_ads_command_status) — Apple Ads commands for one app's campaigns — from the dashboard, from automation rules and from… (1)
- [`GET /apps/{appId}/search-popularity`](https://storelift.net/zh/docs/api/growth/#get_search_popularity) — Apple's own search popularity, from the Apple Ads account connected to this workspace: the most searched… (1)
- [`GET /apps/{appId}/pricing`](https://storelift.net/zh/docs/api/growth/#get_pricing_offers) — Product prices and offer codes for one app from the RevenueCat or Adapty webhook, over the last 365 days:… (1)
- [`GET /apps/{appId}/country-prices`](https://storelift.net/zh/docs/api/growth/#get_country_prices) — Country prices for one of the app's products, read from App Store Connect / Google Play (Pro): per country… (1)
- [`GET /apps/{appId}/change-impact`](https://storelift.net/zh/docs/api/growth/#get_change_impact) — What a change did: for one change day (a new version, screenshots, subtitle, keyword field, a campaign… (1)

## [Hive](https://storelift.net/zh/docs/api/hive/)

Storelift 网络测量到的任意应用或市场，不论你是否追踪它。属于 Hive Explorer。

- [`GET /rank-check`](https://storelift.net/zh/docs/api/hive/#check_rank) — The live rank of one of your apps for any search term in one storefront, as the store shows it right now —… (10)
- [`GET /keyword-difficulty`](https://storelift.net/zh/docs/api/hive/#get_keyword_metrics) — Demand and difficulty inputs for one App Store search term in one storefront: its demand (`demand`) and… (10)
- [`GET /hive/find`](https://storelift.net/zh/docs/api/hive/#find_apps) — Find apps across the top charts we measure: filter by category, storefront, chart (Top Grossing, Top Free,… (20)
- [`GET /hive/charts`](https://storelift.net/zh/docs/api/hive/#market_charts) — One top chart as we last measured it: the ranked app ids for a storefront, list kind and optional… (10)
- [`GET /hive/movers`](https://storelift.net/zh/docs/api/hive/#market_movers) — Who climbed, who fell, who entered and who left one top chart, against the same chart N days ago (10)
- [`GET /hive/new`](https://storelift.net/zh/docs/api/hive/#market_new_apps) — Apps seen on a top chart for the first time, newest first, with the publisher behind each one (10)
- [`GET /hive/publisher/{publisherId}`](https://storelift.net/zh/docs/api/hive/#market_publisher) — Every app of one publisher that we have seen on a chart, with the day each was first seen (10)
- [`GET /hive/resolve`](https://storelift.net/zh/docs/api/hive/#hive_search_apps) — Find any app's id: by name or developer (the top matches in that storefront, with publisher, category,… (10)
- [`GET /hive/similar/{appId}`](https://storelift.net/zh/docs/api/hive/#hive_similar_apps) — The store's own similar-apps shelf for any app (Apple's You Might Also Like, Google's Similar apps), in… (10)
- [`GET /hive/reviews/{appId}`](https://storelift.net/zh/docs/api/hive/#hive_app_reviews) — Any app's recent reviews in one storefront, newest first: stars, title, text, version and date, plus the… (10)
- [`POST /hive/keywords/{term}/metrics/measure`](https://storelift.net/zh/docs/api/hive/#hive_measure_keyword_metrics) — Start a measurement of one keyword's popularity and/or difficulty in one storefront when the stored value… (50)
- [`GET /hive/apps/{id}`](https://storelift.net/zh/docs/api/hive/#hive_app_details) — Any app's latest daily measurement (10)
- [`GET /hive/keywords/{term}/ranks`](https://storelift.net/zh/docs/api/hive/#hive_keyword_ranks) — Who ranks for a keyword, day by day (10)
- [`GET /hive/keywords/{term}/metrics`](https://storelift.net/zh/docs/api/hive/#hive_keyword_metrics) — Read a keyword's current popularity and difficulty (10)
- [`GET /hive/keywords/{term}/metrics/history`](https://storelift.net/zh/docs/api/hive/#hive_keyword_metrics_history) — Read stored keyword metric observations over time (20)
- [`GET /hive/spy/{id}`](https://storelift.net/zh/docs/api/hive/#hive_keyword_spy) — The keywords any app ranks for (200)
- [`GET /hive/estimate/{id}`](https://storelift.net/zh/docs/api/hive/#hive_estimate) — Revenue and downloads for any app (500)
- [`GET /hive/gap`](https://storelift.net/zh/docs/api/hive/#get_keyword_gap) — Keyword gap across several apps (400)
- [`GET /hive/research`](https://storelift.net/zh/docs/api/hive/#hive_keyword_research) — Keyword research from a seed term (50)
- [`GET /hive/landscape`](https://storelift.net/zh/docs/api/hive/#hive_category_landscape) — What it takes to rank in a category (10)

## [写入](https://storelift.net/zh/docs/api/actions/)

每次写入都分两步：先是不做任何改动的预览，再用预览返回的令牌确认。

- [`GET /jobs/{jobId}`](https://storelift.net/zh/docs/api/actions/#get_job) — Status of a long-running job started by a confirmed action (Apple Ads command, review reply, listing… (0)
- [`POST /actions`](https://storelift.net/zh/docs/api/actions/#preview_action) — Preview a write (0)
- [`POST /actions/confirm`](https://storelift.net/zh/docs/api/actions/#confirm_action) — Apply a previewed write (按操作计)