Dokumentation der PlayTop Global

Schnellstart

Basis-URL: https://apiplay.top/api/v1. Registrieren Sie sich, erstellen Sie einen API-Schlüssel in Ihrem Konto und senden Sie Ihre erste Anfrage:

Maschinenlesbare API-Beschreibung: OpenAPI 3.1 · Postman-Collection — in Postman, Insomnia oder einen Client-Generator (openapi-generator) importieren und ein fertiges SDK für Ihre Sprache erhalten.

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

Die Daten umfassen über 4 Millionen Google-Play-Apps aus dem US-Store auf Englisch (aus einem anderen Land, falls eine App in den USA nicht verfügbar ist), nächtlich aktualisiert. Apps, die aus dem Store verschwinden, bleiben mit ihren letzten Daten in der Datenbank.

Authentifizierung

Jede Anfrage außer /v1/health muss den API-Schlüssel in einem Header enthalten:

X-API-Key: ak_live_…

Ebenfalls akzeptiert: Authorization: Bearer …. Der Schlüssel darf nicht in URL-Parametern übergeben werden: Er würde in Logs und im Browserverlauf landen.

Credits & Limits

Jeder Aufruf kostet je nach Endpunkt 0–3 Credits, unabhängig von der Anzahl der Zeilen in der Antwort (bis 100); der Sammelaufruf apps kostet 1 Credit pro App. Zuerst werden die Tarif-Credits des laufenden Monats verbraucht, dann das Prepaid-Guthaben. Schlägt eine Anfrage auf unserer Seite fehl, werden die Credits erstattet. Tarife & Pakete

Ihre verbleibenden Credits stehen auch im Feld _credits jeder Antwort und unter /v1/account (kostenlos).

Antwortformat und Fehler

Jede Antwort hat das Feld ok. Listen enthalten results, total, page, per, pages. Fehler: ok = false, error ist die Erklärung, code ein maschinenlesbarer Code. Datumsangaben sind ISO 8601 in 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. …" }

Endpunkte

Alle Endpunkte sind GET /api/v1/{name}. Paginierung: page (ab 1) und per (1–100), bis zum 10.000. Ergebnis. Sortierung: sort + order=asc|desc.

* — Pflichtparameter

Codebeispiele

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

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

# Python — apps removed from Google Play this week
import os, requests
r = requests.get("https://apiplay.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+ (auf dem Server — nicht im Browser)
const res = await fetch("https://apiplay.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://apiplay.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;

Ausprobieren

Einen Schlüssel erstellen Sie in Ihrem Konto. Die Anfrage geht direkt von Ihrem Browser aus. Der Schlüssel wird nirgends gespeichert und ist nach dem Neuladen der Seite weg. Anfragen aus der Konsole verbrauchen Credits wie alle anderen.