账号接口

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

此工作区的提醒动态：排名下降与上升、关键词进入或退出搜索结果、竞品超过你或被你超过、竞品商店页面的变更、Apple Ads 规则和管理费步骤、已完成的关键词挖掘运行，按时间从新到旧排列，并附未读数量。与仪表板里铃铛图标的动态相同。

参数	位置	类型	说明
`limit`	query	number	行数，最多 500（默认 50）

curl "https://storelift.net/v1/alerts" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

工作区内所有 App 今天的情况，每个 App 一行：实时用户、用户和新用户、广告收入、订阅收入和试用，另有组合总计、按小时和按国家或地区的卡片，以及订阅事件动态。数字与仪表板的“今天”页面相同。传入 day 可查看过去某一天。

参数	位置	类型	说明
`tz`	query	string	用于划分日界的 IANA 时区，例如 Europe/Istanbul（默认 UTC）
`day`	query	string	过去的某一天，格式 YYYY-MM-DD（默认今天）

curl "https://storelift.net/v1/portfolio" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

此密钥或会话的归属信息：套餐、认证方式、带有的权限范围、可读取的 App 以及额度余额。不消耗额度。当调用因套餐、权限范围或 App 原因被拒绝时调用它。

curl "https://storelift.net/v1/account" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

示例响应

工作区的全部配额及其已用量和重置时间：跟踪的关键词、App、关键词挖掘、AI 提问、评论 AI、AI 可见度、关键词侦察、API 额度、今天的 Hive 额度以及每秒速率。不消耗额度。used=null 表示该配额在此套餐下不计量，而不是零。

curl "https://storelift.net/v1/usage" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

示例响应

搜索此账户自己的记录（App 名称和商店 ID、跟踪的关键词，以及排在用户之上的竞品），并返回可传给 fetch 的 ID 列表。用它来定位记录；要在整个商店中发现新 App，请使用 find_apps。

参数	位置	类型	说明
`q`必填	query	string	自由文本：App 名称、关键词、竞品名称或商店 ID

curl "https://storelift.net/v1/search?q=sleep" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

示例响应

search 返回的某个 ID 背后的完整记录：一张 App 卡片、一个带当前状态和排名历史的跟踪关键词，或一个竞品及其胜过用户的关键词。返回 id、title、url、一行 text 和 metadata。

参数	位置	类型	说明
`id`必填	query	string	与 search 返回的完全一致的 ID（app:…、kw:…、rival:…）

curl "https://storelift.net/v1/fetch?id=kw%3Asbx-lumen%3Aus%3Asleep%2520sounds" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

示例响应