APK Surge 文档

快速入门

基础地址： https://apksurge.com/api/v1. 请注册，请在您的以下位置创建 API 密钥： 账户中心 ，然后发送您的第一个请求：

API 的机器可读描述： OpenAPI 3.1 · Postman 集合 — 导入 Postman、Insomnia 或客户端生成器 (openapi-generator)，即可获得适用于您所用语言的现成 SDK。

curl -H "X-API-Key: 您的密钥" "https://apksurge.com/api/v1/app?id=com.whatsapp"

数据涵盖超过 400 万个 Google Play 应用，来自美国商店的英文版本（若应用在美国不可用，则取自其他国家），每晚更新。已从商店下架的应用会连同其最后数据保留在数据库中。

身份验证

除 /v1/health 外，每个请求都必须在请求头中包含 API 密钥：

X-API-Key: ak_live_…

同时支持： Authorization: Bearer …。不允许在 URL 参数中传递密钥：否则它会进入日志和浏览器历史记录。

令牌与限额

每次调用消耗 0–3 个令牌，具体取决于端点，与响应中的行数无关（最多 100 行）；批量 apps 请求每个应用消耗 1 个令牌。优先使用每月令牌，然后使用已购令牌。如果请求因我方原因失败，令牌将退还。 套餐与令牌包

剩余令牌数也包含在每个响应的 _tokens 字段和 /v1/account 中（免费）。旧名称 _credits 和 X-Credits-* 已弃用，但目前仍可使用。

响应格式与错误

每个响应都包含 ok 字段。列表包含 results、total、page、per、pages。出错时：ok = false，error 为说明，code 为机器可读的错误代码。日期采用 UTC 的 ISO 8601 格式。

{ "ok": true, "app": { "id": "com.whatsapp", "title": "WhatsApp", "installs": { "label": "10,000,000,000+", "min": 10000000000, "real": 12445120489 }, … },
  "_tokens": { "cost": 1, "monthly_remaining": 999, "balance": 0, "available": 999, "cached": false } }

{ "ok": false, "code": "insufficient_credits", "error": "Not enough tokens: this call costs 2, you have 1. …" }

端点

所有端点均为 GET /api/v1/{名称}。分页：page（从 1 开始）和 per（1–100），最多到第 10 000 条结果。排序：sort + order=asc|desc。

* — 必填参数

代码示例

# curl — one app
curl -H "X-API-Key: $KEY" "https://apksurge.com/api/v1/app?id=org.telegram.messenger"

# curl — puzzle games with 10M+ installs, best rated first
curl -H "X-API-Key: $KEY" "https://apksurge.com/api/v1/search?category=GAME_PUZZLE&min_installs=10000000&sort=score"

# curl — up to 100 apps in one call (POST, one package per line)
curl -H "X-API-Key: $KEY" --data-binary $'com.whatsapp\norg.telegram.messenger' "https://apksurge.com/api/v1/apps"

# Python — apps removed from Google Play this week
import os, requests
r = requests.get("https://apksurge.com/api/v1/removed",
                 params={"since": "2026-10-20", "min_installs": 100000, "per": 100},
                 headers={"X-API-Key": os.environ["KEY"]}, timeout=30)
r.raise_for_status()
data = r.json()
for app in data["results"]:
    print(app["removed_seen_at"], app["id"], app["installs"]["label"])
print("tokens left:", data["_tokens"]["available"])

// Node.js 18+ (在服务器上，而不是在浏览器中)
const res = await fetch("https://apksurge.com/api/v1/developer?id=5191370068110375942", { headers: { "X-API-Key": process.env.KEY } });
const d = await res.json();
if (!d.ok) throw new Error(d.error);
console.log(d.developer.name, d.developer.apps, d.developer.total_installs);

// PHP
$ch = curl_init('https://apksurge.com/api/v1/keywords?lang=en&q=vpn&per=50');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('KEY')]]);
$d = json_decode(curl_exec($ch), true);
foreach ($d['results'] as $k) echo $k['keyword'], ' — ', $k['apps'], PHP_EOL;

试用

您可以在以下位置创建密钥： 账户中心。请求直接从您的浏览器发出。密钥不会被保存，刷新页面后即消失。 控制台发出的请求与普通请求一样消耗令牌。