Documentation de APK Top Charts

Démarrage rapide

URL de base : https://apkapi.top/api/v1. Inscrivez-vous, créez une clé API dans votre compte et envoyez votre première requête :

Description de l'API lisible par machine : OpenAPI 3.1 · collection Postman — importez-la dans Postman, Insomnia ou un générateur de clients (openapi-generator) pour obtenir un SDK prêt à l'emploi dans votre langage.

curl -H "X-API-Key: VOTRE_CLE" "https://apkapi.top/api/v1/app?id=com.whatsapp"

Les données couvrent plus de 4 millions d'applications Google Play de la vitrine américaine en anglais (d'un autre pays si l'application n'est pas disponible aux États-Unis), actualisées chaque nuit. Les applications qui disparaissent du store restent dans la base avec leurs dernières données.

Authentification

Chaque requête, sauf /v1/health, doit inclure la clé API dans un en-tête :

X-API-Key: ak_live_…

Également accepté : Authorization: Bearer …. Il est interdit de passer la clé dans les paramètres d'URL : elle se retrouverait dans les journaux et l'historique du navigateur.

Jetons et limites

Chaque appel coûte 0 à 3 jetons selon le point de terminaison, quel que soit le nombre de lignes de la réponse (jusqu’à 100) ; l’appel groupé apps coûte 1 jeton par app. Les jetons mensuels sont utilisés d’abord, puis les jetons achetés. Si une requête échoue de notre côté, les jetons sont rendus. Offres et packs

Vos jetons restants figurent aussi dans le champ _tokens de chaque réponse et dans /v1/account (gratuit). Les anciens noms _credits et X-Credits-* sont obsolètes, mais fonctionnent encore.

Format de réponse et erreurs

Chaque réponse contient le champ ok. Les listes contiennent results, total, page, per, pages. Erreur : ok = false, error est l'explication, code un code lisible par machine. Les dates sont en ISO 8601 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

Tous les endpoints sont GET /api/v1/{nom}. Pagination : page (à partir de 1) et per (1–100), jusqu'au 10 000e résultat. Tri : sort + order=asc|desc.

* — paramètre obligatoire

Exemples de code

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

# curl — puzzle games with 10M+ installs, best rated first
curl -H "X-API-Key: $KEY" "https://apkapi.top/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://apkapi.top/api/v1/apps"

# Python — apps removed from Google Play this week
import os, requests
r = requests.get("https://apkapi.top/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+ (sur le serveur — pas dans le navigateur)
const res = await fetch("https://apkapi.top/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://apkapi.top/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;

Essayer

Vous pouvez créer une clé dans votre compte. La requête part directement de votre navigateur. La clé n'est stockée nulle part et disparaît au rechargement de la page. Les requêtes depuis la console consomment des jetons comme les autres.