APK Surge dokumentáció

Gyors kezdés

Alap URL: https://apksurge.com/api/v1. Regisztráljon, hozzon létre API-kulcsot a fiókban és küldje el az első kérését:

Géppel olvasható API-leírás: OpenAPI 3.1 · Postman-gyűjtemény — importálja a Postmanbe, az Insomniába vagy egy kliensgenerátorba (openapi-generator), és kész SDK-t kap a saját nyelvéhez.

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

Az adatok több mint 4 millió Google Play alkalmazásra vonatkoznak az amerikai áruházból, angol nyelven (ha az alkalmazás ott nem érhető el, másik országból), éjszakai frissítéssel. Az áruházból eltűnt alkalmazások az utolsó adataikkal az adatbázisban maradnak.

Hitelesítés

A /v1/health kivételével minden kérésnek tartalmaznia kell az API-kulcsot a fejlécben:

X-API-Key: ak_live_…

Elfogadott még: Authorization: Bearer …. A kulcsot nem szabad URL-paraméterben átadni: így naplókba és a böngésző előzményei közé kerülne.

Tokenek és korlátok

Minden hívás 0–3 tokenbe kerül a végponttól függően, a válasz sorainak számától függetlenül (legfeljebb 100); az apps kötegelt kérés alkalmazásonként 1 tokenbe kerül. Előbb a havi tokenek fogynak, utána a megvásároltak. Ha a kérés a mi oldalunkon hiúsul meg, a tokeneket visszaadjuk. Csomagok és tokencsomagok

A megmaradt tokenek számát minden válasz _tokens mezője és a /v1/account (ingyenes) is tartalmazza. A régi _credits és X-Credits-* nevek elavultak, de egyelőre működnek.

Válaszformátum és hibák

Minden válasz tartalmaz egy ok mezőt. A listák results, total, page, per, pages mezőket tartalmaznak. Hiba esetén: ok = false, az error a magyarázat, a code a géppel olvasható kód. A dátumok ISO 8601 formátumúak, UTC-ben.

{ "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. …" }

Végpontok

Minden végpont GET /api/v1/{név}. Lapozás: page (1-től) és per (1–100), legfeljebb a 10 000. találatig. Rendezés: sort + order=asc|desc.

* — kötelező paraméter

Kódpéldák

# 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+ (a szerveren – nem a böngészőben)
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;

Kipróbálás

A kulcs létrehozható a fiókban. A kérés közvetlenül az Ön böngészőjéből indul. A kulcsot sehol nem tároljuk, az oldal újratöltése után eltűnik. A konzolról küldött kérések ugyanúgy használnak tokent, mint a többi.