APK Surge-documentatie

Snelstart

Basis-URL: https://apksurge.com/api/v1. Registreer, maak een API-sleutel aan in uw account en stuur uw eerste verzoek:

Machineleesbare API-beschrijving: OpenAPI 3.1 · Postman-collectie — importeer hem in Postman, Insomnia of een clientgenerator (openapi-generator) en u krijgt een kant-en-klare SDK voor uw taal.

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

De gegevens omvatten meer dan 4 miljoen Google Play-apps uit de Amerikaanse storefront in het Engels (uit een ander land als een app niet in de VS beschikbaar is), elke nacht ververst. Apps die uit de store verdwijnen, blijven met hun laatste gegevens in de database.

Authenticatie

Elk verzoek, behalve /v1/health, moet de API-sleutel in een header bevatten:

X-API-Key: ak_live_…

Ook geaccepteerd: Authorization: Bearer …. De sleutel doorgeven in URL-parameters is niet toegestaan: hij zou in logs en de browsergeschiedenis terechtkomen.

Tokens en limieten

Elke aanroep kost 0–3 tokens, afhankelijk van het endpoint, ongeacht het aantal rijen in het antwoord (tot 100); de batchaanroep apps kost 1 token per app. Eerst worden de maandelijkse tokens gebruikt, daarna de gekochte. Mislukt een verzoek door een fout van onze kant, dan worden de tokens teruggegeven. Plannen en pakketten

Uw resterende tokens staan ook in het veld _tokens van elk antwoord en in /v1/account (gratis). De oude namen _credits en X-Credits-* zijn verouderd, maar werken nog.

Antwoordformaat en fouten

Elk antwoord heeft een veld ok. Lijsten bevatten results, total, page, per, pages. Fout: ok = false, error is de uitleg, code is een machineleesbare code. Datums zijn ISO 8601 in UTC.

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

Endpoints

Alle endpoints zijn GET /api/v1/{naam}. Paginering: page (vanaf 1) en per (1–100), tot en met het 10.000e resultaat. Sorteren: sort + order=asc|desc.

* — verplichte parameter

Codevoorbeelden

# 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+ (op de server — niet in de browser)
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;

Proberen

U kunt een sleutel aanmaken in uw account. Het verzoek gaat rechtstreeks vanuit uw browser. De sleutel wordt nergens opgeslagen en verdwijnt na het herladen van de pagina. Verzoeken vanuit de console kosten tokens zoals alle andere.