Hive 接口

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

GET `/rank-check`

你的某个 App 在某个店面中对任意搜索词的实时排名，按商店此刻显示的情况给出，该词无需被跟踪。状态用来区分不同情况：ranked 附排名和紧挨在上面的 App，absent 附靠前的结果（App 在该店面销售，但位于这些结果之外），not_in_store（App 未在该店面销售）。

权限范围: apps:read
额度: 10
套餐: Free

参数	位置	类型	说明
`app`必填	query	string	App Store 链接或 ID，或 Google Play 链接或包名
`term`必填	query	string	搜索词，例如 habit tracker
`cc`	query	string	店面代码，例如 us
`platform`	query	ios \| android	可选；从 App 链接中读取

curl "https://storelift.net/v1/rank-check?app=us&term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/keyword-difficulty`

某个 App Store 搜索词在某个店面的需求和难度输入项：其需求（demand）和相关搜索、靠前的结果及其评分数和标题中是否包含该词、其中最高的评分数和评分数中位数，以及结果的深度。thin 标记结果少于十个的词；zayifEslesme 标记商店匹配较宽松的词。Free 可读取账户在该店面跟踪的词；Pro 及以上可读取任意词。

权限范围: apps:read
额度: 10
套餐: Free

参数	位置	类型	说明
`term`必填	query	string	搜索词，例如 habit tracker
`cc`	query	string	店面代码，例如 us

curl "https://storelift.net/v1/keyword-difficulty?term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/find`

在我们测量的排行榜中查找 App：可按类别、店面、榜单（畅销榜、免费榜、付费榜或 iPad 榜）、排名范围、首次出现日期、名称或开发者筛选，也可按月收入、月下载量或 30 天增长筛选。传入 estimates: true 可从 Hive 获取每行的月收入和下载量，各一个数字，并附该数字的日期。设置了收入、下载量或增长筛选条件时，Hive 尚无数字的 App 会被排除，并计入 noEstimate。列表消耗 20 额度；带数字，或带收入、下载量或增长筛选条件时，每返回一行另加 50 额度。回答中带有 coverage，即首次出现索引开始的日期，因此你读到的每个日期都是我们已索引的日子。

权限范围: hive:read
额度: 20
套餐: Hive Explorer

参数	位置	类型	说明
`genre`	query	string	最多 3 个 Apple 类别 ID，以逗号分隔，例如 6007,6012
`country`	query	string	最多 5 个店面代码，以逗号分隔，例如 us,gb
`kind`	query	string	grossing、free、paid 或 ipad（App 所在的榜单）
`released`	query	number	在最近 N 个月内首次出现
`rankMin`	query	number	最佳榜单排名不小于此值
`rankMax`	query	number	最佳榜单排名不大于此值
`revenueMin`	query	number	月总收入不低于此值（美元）
`revenueMax`	query	number	月总收入不高于此值（美元）
`downloadsMin`	query	number	月下载量不低于此值
`downloadsMax`	query	number	月下载量不高于此值
`growthMin`	query	number	30 天变化不低于此值，以百分比计（例如 20）
`growthMax`	query	number	30 天变化不高于此值，以百分比计
`text`	query	string	按 App 名称或开发者名称匹配
`publisher`	query	string	来自 market_publisher 的开发者 ID
`estimates`	query	boolean	为 true 时，每行都加上月收入和下载量（每行 50 额度）
`limit`	query	number	每页行数，默认 50，最多 200
`page`	query	number	结果页码，默认 1

curl "https://storelift.net/v1/hive/find?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/charts`

我们最近一次测量到的某个排行榜：某个店面、榜单类型和可选类别下按排名排列的 App ID，并附读取日期。传入 estimates: true 可获取每个名次的月度数值（畅销榜为收入，免费榜为下载量），以及进入第 10、第 50 和第 100 名所需的水平。列表消耗 10 额度；使用 estimates: true 时，每返回一行另加 50 额度。仅限 App Store：Google Play 没有公开的排行榜，在那里给出数字就是编造。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`kind`	query	string	free、paid 或 grossing
`genre`	query	string	Apple 类别 ID，例如 6007；总榜请省略
`limit`	query	number	行数，最多 100

还接受: country

curl "https://storelift.net/v1/hive/charts?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/movers`

与 N 天前的同一排行榜相比，谁上升、谁下降、谁上榜、谁离榜。measured 告诉你对比日的数据已经到位，因此你读到的每个变化值都介于两个已测量的日子之间；离榜的 App 带的是最后的排名而不是变化值，因为今天它们已不在榜上。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`kind`	query	string	free、paid 或 grossing
`genre`	query	string	Apple 类别 ID；总榜请省略
`days`	query	number	与 N 天前比较，最多 90
`limit`	query	number	每个方向的行数，最多 100

还接受: country

curl "https://storelift.net/v1/hive/movers?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/new`

首次出现在排行榜上的 App，从新到旧排列，并附各自的开发者。daysCovered 说明所请求的天数中索引涵盖了多少天，因此你读到的每个首次出现日期都是我们已索引的日子。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`days`	query	number	回溯 N 天，最多 30
`country`	query	string	店面代码；所有店面请省略
`limit`	query	number	行数，最多 200

curl "https://storelift.net/v1/hive/new?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/publisher/{publisherId}`

某个开发者在排行榜上被我们看到过的所有 App，并附各自首次出现的日期。该开发者从未上榜的 App 不在其中：我们列出的是测量到的，而不是存在的全部。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`publisherId`必填	path	string	开发者 ID，例如来自 market_new_apps

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

GET `/hive/resolve`

查找任意 App 的 ID：可按名称或开发者查找（该店面里最匹配的结果，附开发者、类别、评分和评分数），也可通过 App Store / Google Play 链接、单独的 App Store ID 或包名查找。当你只有名称时，请在 hive_app_details、hive_similar_apps 或 hive_app_reviews 之前使用它。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`q`必填	query	string	App 名称、开发者名称、商店链接、App Store ID 或包名
`limit`	query	number	结果数，最多 25（默认 10）

还接受: country

curl "https://storelift.net/v1/hive/resolve?q=sleep&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/similar/{appId}`

商店自己为任意 App 提供的类似 App 货架（Apple 的 You Might Also Like、Google 的 Similar apps），按货架顺序排列，并附每个 App 的类别、名称和开发者，以及读取货架的日期。货架上的类别反映了商店把该 App 归入哪一类人群。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`appId`必填	path	string	App Store ID（例如 570060128）或 Google Play 包名
`country`	query	string	店面代码，例如 us（留空 = 在任意店面中最近读取的货架）

curl "https://storelift.net/v1/hive/similar/sbx-lumen?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/reviews/{appId}`

任意 App 在某个店面的近期评论，从新到旧排列：星级、标题、正文、版本和日期，并附所返回行的星级分布。不含评论者姓名。Hive 中尚未收录的 App 会在第一次调用时加入。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`appId`必填	path	string	App Store ID（例如 570060128）或 Google Play 包名
`limit`	query	number	评论数，最多 200（默认 50）

还接受: country

curl "https://storelift.net/v1/hive/reviews/sbx-lumen?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

POST `/hive/keywords/{term}/metrics/measure`

当保存的值缺失或已过时时，启动对某个关键词在某个店面的热度和/或难度的测量。新鲜的值或已核实的缺失会直接返回，不产生新的工作；加入已在运行的作业的请求不占用每日测量单位；启动新工作的请求会从工作区的每日 Hive 测量额度中占用一个单位。两项指标相互独立：某个数据源失败时，另一项有效指标仍保留在回答中。wait（0–20 秒）会让调用保持打开，直到结果保存完毕；202 表示仍在运行，稍后用 hive_keyword_metrics 读取。需要选择加入的 hive:measure 权限范围：在 API 密钥上选定，或在通过 OAuth 连接时单独批准。仅限 iOS。

权限范围: hive:measure
额度: 50
套餐: Hive Explorer

参数	位置	类型	说明
`term`必填	path	string	精确的关键词，例如 habit tracker
`country`	body	string	店面代码，例如 us（默认 us）
`platform`	body	string
`metrics`	body	array	要测量的指标（默认两项都测）
`wait`	body	number	等待已保存结果的秒数，0–20（省略时此工具发送 15；HTTP API 的默认值为 0）

发起新的任务会用掉工作区每日 Hive 测量上限中的一次，所以这里没有可复制的命令。

请求体

{"country":"us","platform":"ios","metrics":["popularity","difficulty"],"wait":15}

GET `/hive/apps/{id}`

网络在最近一天为任意 App 测量到的商店详情：名称、评分数、评分、版本、价格、分发情况、徽章和 App 内购买项目数量。对于 App Store 的 App，listingExtras 会附上支持的语言、星级分布（1★ 到 5★）、正在进行和即将开始的 App 内活动、推广文本以及推荐的 App 内购买项目，并带有自己的 measuredAt；未测量时为 null。not_measured 指出应把该 App 添加到哪些店面。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`id`必填	path	string	App Store ID（5–12 位数字）或 Google Play 包名。

还接受: country

curl "https://storelift.net/v1/hive/apps/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/keywords/{term}/ranks`

网络所测量的任意关键词的靠前结果，按天返回。top 较大时 days 会缩短，以便一次调用不超过 1,000 行。7 天以内 10 额度，30 天以内 20，90 天以内 40。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型
`term`必填	path	string
`top`	query	integer
`days`	query	integer

还接受: country · platform

curl "https://storelift.net/v1/hive/keywords/sleep/ranks?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/keywords/{term}/metrics`

读取某个精确关键词和店面的现有 Hive 观测值。热度是 1 到 100 的整数；难度是 0 到 100 的分数。缺失的数据保持为 null。每项指标都带有各自的依据、数据源时间、新鲜度和最近一次尝试的状态。此 GET 绝不会发起数据源请求或测量作业。需要完整的 Hive Explorer 产品；明确不支持 Android。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`term`必填	path	string	经 NFC 规范化、去除首尾空白并转为小写。内部空白仍然有意义。
`platform`	query	ios	默认为 ios

还接受: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/keywords/{term}/metrics/history`

读取某个关键词已保存的每日历史：每天记录的搜索结果、难度分数和 Apple 热度。过去的难度值保持记录时的原样。失败和不完整的日期会如实标出；没有已保存记录的日期既不代表零，也不代表已核实的缺失。使用相同的 keyword、storefront 和 days 跟随 pagination.nextCursor。每个序列单独分页，每页最多 200 条记录。此 GET 只读取已保存的历史，绝不会发起测量。需要完整的 Hive Explorer 产品；明确不支持 Android。7 天以内 10 额度，30 天以内 20，90 天以内 40。

权限范围: hive:read
额度: 20
套餐: Hive Explorer

参数	位置	类型	说明
`term`必填	path	string	经 NFC 规范化、去除首尾空白并转为小写。内部空白仍然有意义。
`platform`	query	ios	默认为 ios
`days`	query	integer	包含今天在内的 UTC 自然日天数。热度修订按其数据源周起始日是否落在此范围内来选取。
`cursor`	query	string	来自这一查询本身的 pagination.nextCursor 的不透明续传值。

还接受: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/spy/{id}`

网络为某个 App 测量过的所有关键词及其排名。每次调用都以额度支付；没有可显示关键词的 App 消耗 1 额度。

权限范围: hive:spy
额度: 200
套餐: Hive Explorer

参数	位置	类型	说明
`id`必填	path	string	App Store ID（5–12 位数字）或 Google Play 包名。

还接受: country · platform

curl "https://storelift.net/v1/hive/spy/1000000104?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/estimate/{id}`

任意 App Store App 的全球月收入和下载量：各一个数字（value，App 低于该数额时为 under），以及它覆盖多少个市场。每个 App 都会得到回答。Hive 早已知道。对某个 App 的第一次请求会启动读取，并返回 202 及 eta 秒数。数字消耗 500 额度；待处理的回答消耗 1 额度。

权限范围: hive:estimate
额度: 500
套餐: Hive Explorer

参数	位置	类型	说明
`id`必填	path	string	App Store ID。

还接受: country

curl "https://storelift.net/v1/hive/estimate/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

在沙盒中打开

示例响应

GET `/hive/gap`

最多 5 个 App 的关键词列表并排展示，每个关键词一行：每个 App 的排名、有多少个 App 有排名以及哪些缺失。每个参与比较的 App 消耗 200 额度；不在索引中的 App 不计费。属于 Explorer。

权限范围: hive:spy
额度: 400
套餐: Hive Explorer

参数	位置	类型	说明
`ids`必填	query	string	以逗号分隔的 App ID，至少 2 个。

还接受: country · platform

curl "https://storelift.net/v1/hive/gap?ids=1000000001,1000000104&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/research`

输入一个种子关键词，即可获得相关的 App Store 搜索词，每个都附 Apple 热度（有观测时为 1–100；缺失的值保持为 null）、难度（0–100）、有多少个 App 在该词上有排名以及前 10 个 App。指标依据会区分已测量的值、已核实的缺失、待处理的工作和数据源错误。正在测量的行带有 state: "pending"；重复请求即可读取结果。当 App Store 更正某个词的拼写时，该行会在 spell 中给出更正后的搜索词。不需要 App。属于 Explorer。

权限范围: hive:read
额度: 50
套餐: Hive Explorer

参数	位置	类型	说明
`seed`必填	query	string	种子关键词。
`compare`	query	string	最多再加 5 个店面，以逗号分隔（例如 de,fr）：同一批词在每个店面的热度、难度和 App 数量。

还接受: country

curl "https://storelift.net/v1/hive/research?seed=us&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/landscape`

从某个店面的免费榜看其类别格局：前 10 名的评分数门槛、评分中位数、名称长度、发布和更新的新近程度、语言、大小，以及拥有多个 App 的开发者。每个类别都带有各自的测量日。

权限范围: hive:read
额度: 10
套餐: Hive Explorer

参数	位置	类型	说明
`genre`	query	string	App Store 类别 ID（例如 6014）或类别键（all, games, entertainment, photo-video, productivity, health-fitness, education, lifestyle, finance, social-networking）。省略则返回所有已测量的类别。

还接受: country

curl "https://storelift.net/v1/hive/landscape?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Hive 接口

GET /rank-check

GET /keyword-difficulty

GET /hive/find

GET /hive/charts

GET /hive/movers

GET /hive/new

GET /hive/publisher/{publisherId}

GET /hive/resolve

GET /hive/similar/{appId}

GET /hive/reviews/{appId}

POST /hive/keywords/{term}/metrics/measure

GET /hive/apps/{id}

GET /hive/keywords/{term}/ranks

GET /hive/keywords/{term}/metrics

GET /hive/keywords/{term}/metrics/history

GET /hive/spy/{id}

GET /hive/estimate/{id}

GET /hive/gap

GET /hive/research

GET /hive/landscape

GET `/rank-check`

GET `/keyword-difficulty`

GET `/hive/find`

GET `/hive/charts`

GET `/hive/movers`

GET `/hive/new`

GET `/hive/publisher/{publisherId}`

GET `/hive/resolve`

GET `/hive/similar/{appId}`

GET `/hive/reviews/{appId}`

POST `/hive/keywords/{term}/metrics/measure`

GET `/hive/apps/{id}`

GET `/hive/keywords/{term}/ranks`

GET `/hive/keywords/{term}/metrics`

GET `/hive/keywords/{term}/metrics/history`

GET `/hive/spy/{id}`

GET `/hive/estimate/{id}`

GET `/hive/gap`

GET `/hive/research`

GET `/hive/landscape`