APK Surge-dokumentasjon

Hurtigstart

Basis-URL: https://apksurge.com/api/v1. Registrer deg, opprett en API-nøkkel i kontoen din og send din første forespørsel:

Maskinlesbar API-beskrivelse: OpenAPI 3.1 · Postman-samling — importer den i Postman, Insomnia eller en klientgenerator (openapi-generator) og få en ferdig SDK for ditt språk.

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

Dataene dekker over 4 millioner Google Play-apper fra den amerikanske butikken på engelsk (fra et annet land hvis appen ikke finnes i USA), oppdatert hver natt. Apper som forsvinner fra butikken blir værende i databasen med sine siste data.

Autentisering

Hver forespørsel unntatt /v1/health må inneholde API-nøkkelen i en header:

X-API-Key: ak_live_…

Aksepteres også: Authorization: Bearer …. Det er ikke tillatt å sende nøkkelen i URL-parametere: da ville den havne i logger og nettleserhistorikk.

Tokener og grenser

Hvert kall koster 0–3 tokener avhengig av endepunktet, uavhengig av antall rader i svaret (opptil 100); batch-kallet apps koster 1 token per app. Månedlige tokener brukes først, deretter kjøpte. Hvis en forespørsel mislykkes på vår side, får du tokenene tilbake. Planer og pakker

Gjenstående tokener finnes også i feltet _tokens i hvert svar og i /v1/account (gratis). De gamle navnene _credits og X-Credits-* er utdaterte, men fungerer fortsatt.

Svarformat og feil

Hvert svar har feltet ok. Lister inneholder results, total, page, per, pages. Feil: ok = false, error er forklaringen, code er en maskinlesbar kode. Datoer er i ISO 8601 i 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. …" }

Endepunkter

Alle endepunkter er GET /api/v1/{navn}. Paginering: page (fra 1) og per (1–100), opptil resultat nr. 10 000. Sortering: sort + order=asc|desc.

* — påkrevd parameter

Kodeeksempler

# 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+ (på serveren — ikke i nettleseren)
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;

Prøv

Du kan opprette en nøkkel i kontoen din. Forespørselen sendes direkte fra nettleseren din. Nøkkelen lagres ikke noe sted og forsvinner når siden lastes inn på nytt. Forespørsler fra konsollen bruker tokener på samme måte som alle andre.