Documentation de Fresh on Play

Démarrage rapide

URL de base : https://apiapk.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://apiapk.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.

Crédits et limites

Chaque appel coûte 0 à 3 crédits selon le endpoint, quel que soit le nombre de lignes de la réponse (jusqu'à 100) ; l'appel groupé apps coûte 1 crédit par application. Les crédits de l'offre du mois en cours sont utilisés en premier, puis le solde prépayé. Si une requête échoue de notre côté, les crédits sont restitués. Offres et packs

Vos crédits restants figurent aussi dans le champ _credits de chaque réponse et dans /v1/account (gratuit).

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 }, … },
  "_credits": { "cost": 1, "plan_remaining": 1999, "balance": 0, "available": 1999, "cached": false } }

{ "ok": false, "code": "insufficient_credits", "error": "Not enough credits: 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://apiapk.top/api/v1/app?id=org.telegram.messenger"

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

# Python — apps removed from Google Play this week
import os, requests
r = requests.get("https://apiapk.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("credits left:", data["_credits"]["available"])

// Node.js 18+ (sur le serveur — pas dans le navigateur)
const res = await fetch("https://apiapk.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://apiapk.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 crédits comme les autres.