OpenAPI
Apps 榜单
查询全部 App、下载收入、商店榜或预约榜数据。
POST
/v1/apps/rankings- 认证方式
- X-API-Key
- 所需 scope
apps:rankings:read- 计费
- 价格以账户生效规则为准
- 限流
- 查看当前限流规则
请求参数
该请求使用 JSON 请求体提交。
ranking_typestring必填all · download · revenue · store_rank · pre_order
date_monthstring可选data_datestring可选pageinteger可选默认值: 1
1 ≤ page ≤ ∞
sizeinteger可选默认值: 10
1 ≤ size ≤ 100
allow_realtimeboolean可选默认值: false
keywordstring可选platformstring可选scopestring可选chart_typestring可选country_idstring可选genre_idstring可选osstring可选areastring可选categorystring可选price_typestring可选free · paid
in_app_purchasestring可选Y · N
ratingstring可选4_5 · 4_0 · 3_0 · unrated
release_datestring可选last_release_datestring可选languagestring可选响应
successboolean必填dataobject可选rankings 接口响应。
展开字段
sourcestring必填ranking_typestring必填data_datestring必填updated_atstring可选totalinteger可选默认值: 0
applied_filtersobject可选recordsarray可选展开字段
rankinteger可选rank_changeinteger可选app_idstring可选bundle_idstring可选diandian_idstring可选app_namestring可选logo_urlstring可选developerstring可选developer_urlstring可选platformstring可选devicestring可选country_idstring可选countrystring可选categorystring可选genresarray可选展开字段
该接口暂不提供 Schema 详情。
ratingnumber可选rating_countinteger可选rating_count_listarray可选展开字段
该接口暂不提供 Schema 详情。
store_ratingnumber可选store_rating_countinteger可选store_rating_sequencearray可选展开字段
该接口暂不提供 Schema 详情。
store_screenshotsarray可选展开字段
该接口暂不提供 Schema 详情。
store_languagesstring可选pricenumber可选price_unitstring可选price_labelstring可选release_datestring可选last_release_datestring可选versionstring可选descriptionstring可选store_urlstring可选is_adinteger可选is_tecdo_advinteger可选industriesarray可选展开字段
该接口暂不提供 Schema 详情。
metric_keystring可选metric_valuenumber可选sourcestring必填report_datestring必填crawl_datestring可选update_timestring可选fallback_usedboolean可选默认值: false
fallback_reasonstring可选cache_statusstring可选hit · miss · stale · bypass
upstream_endpointstring可选errorobject可选错误详情
展开字段
codeinteger必填业务错误码
messagestring必填可读错误信息
metaobject可选响应元数据
展开字段
request_idstring可选请求唯一标识
默认值: ""
pageinteger可选当前页码
sizeinteger可选每页数量
totalinteger可选总数
quota_remaininginteger可选剩余配额（-1 表示不限制）
默认值: -1
service_levelstring可选本次请求的服务等级
langstring可选响应语言（cn/en），为空表示未翻译
platformstring可选本次请求的达人平台
recall_typestring可选召回类型：hybrid / vector / scalar
credits_consumedinteger可选本次请求扣减的积分数
默认值: 0
credits_remaininginteger可选积分余额（-1 不限制）
默认值: -1
billable_unitsinteger可选Server-calculated billable units for this response
默认值: 0
0 ≤ billable_units ≤ ∞
skill_namestring可选调用方 skill 名称
skill_current_versionstring可选调用方 skill 当前版本
skill_latest_versionstring可选服务端声明的最新 skill 版本
skill_min_supported_versionstring可选服务端声明的最低支持版本
skill_update_availableboolean可选是否存在可用 skill 更新
默认值: false
skill_update_requiredboolean可选是否要求更新 skill 后再继续使用
默认值: false
skill_update_messagestring可选skill 更新提示文案
skill_update_manifest_urlstring可选skill 更新 manifest URL