收入与 Apple Ads 接口
每款应用已连接的数据来源：收入、订阅事件、App Store 转化漏斗、价格和优惠代码、一次改动前后的对比，以及 Apple Ads 的广告系列、关键词、搜索词和命令。权限范围为 revenue:read 和 ads:read。
身份验证 · 额度 · 通用参数 · 错误代码 · openapi.json
GET /apps/{appId}/revenue
来自用户已连接数据源的某个 App 的收入和下载量：App Store Connect 各国家或地区的每日销量、Google Play 的每日安装量，以及 RevenueCat 的 MRR、28 天收入、活跃订阅和试用，并附 MRR 变动明细。connected=false 表示没有连接任何数据源；measured=false 表示数据源中没有此 App 的数据行。这里没有任何估算值。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
days | query | integer | 返回每日序列的天数，1–365（默认 90） |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/revenue" \
-H "Authorization: Bearer $STORELIFT_API_KEY"示例响应
GET /apps/{appId}/subscriptions
来自 RevenueCat / Adapty Webhook 的某个 App 的订阅事件数：按天和按国家或地区统计试用开始、试用转化、付费开始、续订、取消、退款、扣款问题和收入，另有按月的同期群（用户、付费用户）。统计的是事件，不是用户。connected=false 表示没有连接 Webhook。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
days | query | integer | 时间窗口（天），1–365（默认 90） |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/subscriptions" \
-H "Authorization: Bearer $STORELIFT_API_KEY"示例响应
GET /apps/{appId}/funnel
来自 App Store Connect 分析的某个 App 的 App Store 转化漏斗：展示次数 → 产品页面浏览次数 → 下载量，包含今天的数据点和按天的历史，并在 Apple 提供时附流量来源和自定产品页面的细分。Google Play 在这里没有对应的数据。connected=false 表示尚未连接 App Store Connect。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
days | query | integer | 历史窗口（天），1–365（默认 90） |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/funnel" \
-H "Authorization: Bearer $STORELIFT_API_KEY"示例响应
GET /apps/{appId}/campaigns
推广某个 App 的 Apple Ads 广告系列（按 App 的 App Store ID 匹配，而不是按名称）：最近 28 天内每个广告系列的花费、展示次数、点按、安装量、预算和投放状态，以及总计和花费最高的关键词与搜索词。花费以账户自身的货币（currency）计。connected=false 表示尚未连接 Apple Ads。
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/campaigns" \
-H "Authorization: Bearer $STORELIFT_API_KEY"示例响应
GET /apps/{appId}/ads-keywords
为某个 App 在其所有广告系列中购买的全部 Apple Ads 关键词（最近 28 天），按花费排序：出价、匹配类型、广告组、花费、展示次数、点按、安装量、点按率、转化率、单次点按成本和每次安装成本，并在旁边列出该 App 在该国家或地区对同一个词的自然排名（未跟踪该词时为 tracked:false）。传入 campaign 可限定到一个广告系列。connected=false 表示尚未连接 Apple Ads。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
country | query | string | 自然排名列所用的国家或地区代码（默认为该 App 的第一个国家或地区） |
campaign | query | string | 用于限定到一个广告系列的广告系列 ID |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/ads-keywords?country=us" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /apps/{appId}/ads-search-terms
触发了该 App 的 Apple Ads 的、人们实际输入的搜索（最近 28 天），按花费排序：搜索词、匹配到它的关键词和匹配类型、花费、点按、安装量、单次点按成本和每次安装成本，并并排列出该 App 在该国家或地区对这一搜索的自然排名。这份列表可以告诉你哪些搜索该添加为关键词、哪些该添加为否定关键词，以及哪些因为 App 已有排名而不必再付费。Apple 因搜索量低而隐藏的词汇总在 hidden 下。connected=false 表示尚未连接 Apple Ads。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
country | query | string | 自然排名列所用的国家或地区代码（默认为该 App 的第一个国家或地区） |
campaign | query | string | 用于限定到一个广告系列的广告系列 ID |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/ads-search-terms?country=us" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /apps/{appId}/ads-commands
针对某个 App 的广告系列的 Apple Ads 指令，来自仪表板、自动化规则和 confirm_action，从新到旧排列，每条都带状态：queued、applying、applied、failed 或 unknown（发送中途中断，可能已到达 Apple，也可能没有，重新发送前请先在 Apple Ads 中核实），以及完成时间、错误（如有）和它附带的撤销操作。传入 id 可获取单条指令。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
id | query | string | 列表中返回的指令 ID，用于获取单条指令 |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/ads-commands" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /apps/{appId}/search-popularity
Apple 自己的搜索热度，来自连接到此工作区的 Apple Ads 账户：该国家或地区中 App 所属类别搜索最多的词（每周，按 Apple 的顺序），每个都附类别内排名、热度 1-100（类别内和整个国家或地区）和 1-5（Apple Ads 的刻度），另外每个跟踪的关键词都标记 inTopTerms 为 true 或 false。传入 terms 可查询更多词。connected=false 表示尚未连接 Apple Ads。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
terms | query | string | 要额外查询的词，以逗号分隔，最多 50 个 |
limit | query | number | 返回的热门词数量，最多 200（默认 50） |
还接受: appId (必填) · country
curl "https://storelift.net/v1/apps/sbx-lumen/search-popularity?country=us" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /apps/{appId}/pricing
来自 RevenueCat 或 Adapty Webhook 的某个 App 的产品价格和优惠代码，覆盖最近 365 天：按产品和国家或地区，给出当前生效的价格（货币、当地价格、生效起始日）以及每个固定价格时段的试用开始、新增付费订阅、试用转化和收入，另有每个优惠代码的首日、末日和兑换次数。价格变更会显示为一个新时段，因此可以逐时段对比前后。connected=false 表示两个 Webhook 都没有连接。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
country | query | string | 用于限定到一个店面的两位字母国家或地区代码 |
product | query | string | 用于限定到一个产品的商店产品 ID |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/pricing?country=us" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /apps/{appId}/country-prices
该 App 某个产品的各国家或地区价格，读取自 App Store Connect / Google Play（Pro）：每个国家或地区的当地价格、其美元价值和指数（美国 = 100）、是否仍为 Apple（或 Google）的自动价格、对价格做了本地化的竞品的中位数（相对 Apple 自动价格的倍数，并附竞品数量）及百分比差异，另有取整到有吸引力价位的建议价格及其理由（竞品中位数或收入档位）。竞品是该 App 手动添加的 iOS 竞品；一个国家或地区至少需要 3 个竞品才能比较。summary 统计定价高于和低于竞品的国家或地区数量，以及仍使用自动价格的数量。state 为 not_connected、pending（首次读取尚未完成）、permission（密钥的角色无法读取价格）、no_products 或 ok。products 列出其他产品；传入 product 可切换。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
country | query | string | 用于只返回一行的两位字母国家或地区代码 |
product | query | string | 产品 ID 或 SKU（默认为第一个产品） |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/country-prices?country=us" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /apps/{appId}/change-impact
一次变更带来了什么：针对某个变更日（新版本、截图、副标题、关键词字段、广告系列开始，默认为商店页面时间线上的最新变更），并排比较前后相同天数的数据：关键词排名（上升/下降/进入/跌出以及最大的变动）、App Store 漏斗（每天的展示次数、页面浏览次数、下载量以及转化率）、销售报告中的下载量，以及每天的订阅收入和试用/付费开始，每项都附百分比变化。变更日当天不计入两个窗口。complete=false 表示变更后的窗口仍在进行中。recentChanges 列出最近的变更日，可另选一个。
| 参数 | 位置 | 类型 | 说明 |
|---|---|---|---|
country | query | string | 用于排名和商店页面时间线的国家或地区代码（默认为该 App 的第一个国家或地区） |
day | query | string | 变更日 YYYY-MM-DD（默认为最新变更） |
window | query | integer | 前后各多少天，3–30（默认 7） |
还接受: appId (必填)
curl "https://storelift.net/v1/apps/sbx-lumen/change-impact?country=us" \
-H "Authorization: Bearer $STORELIFT_API_KEY"