Documentación de PlayTop Global

Inicio rápido

URL base: https://apiplay.top/api/v1. Regístrate, crea una clave API en tu cuenta y envía tu primera solicitud:

Descripción de la API legible por máquina: OpenAPI 3.1 · colección de Postman — impórtala en Postman, Insomnia o un generador de clientes (openapi-generator) y obtendrás un SDK listo para tu lenguaje.

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

Los datos cubren más de 4 millones de apps de Google Play de la tienda de EE. UU. en inglés (de otro país si la app no está en EE. UU.), actualizados cada noche. Las apps que desaparecen de la tienda permanecen en la base con sus últimos datos.

Autenticación

Toda solicitud, salvo /v1/health, debe incluir la clave API en una cabecera:

X-API-Key: ak_live_…

También se acepta: Authorization: Bearer …. No se permite pasar la clave en los parámetros de la URL: acabaría en los registros y en el historial del navegador.

Créditos y límites

Cada llamada cuesta 0–3 créditos según el endpoint, sin importar cuántas filas devuelva (hasta 100); la llamada por lotes apps cuesta 1 crédito por app. Primero se gastan los créditos del plan del mes en curso y luego el saldo prepago. Si la solicitud falla por nuestra parte, los créditos se devuelven. Planes y paquetes

Tus créditos restantes también aparecen en el campo _credits de cada respuesta y en /v1/account (gratis).

Formato de respuesta y errores

Cada respuesta tiene el campo ok. Las listas contienen results, total, page, per, pages. Error: ok = false, error es la explicación, code es un código para máquinas. Las fechas son ISO 8601 en 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

Todos los endpoints son GET /api/v1/{nombre}. Paginación: page (desde 1) y per (1–100), hasta el resultado 10.000. Orden: sort + order=asc|desc.

* — parámetro obligatorio

Ejemplos de código

# 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+ (en el servidor, no en el navegador)
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;

Pruébalo

Puedes crear una clave en tu cuenta. La solicitud va directamente desde tu navegador. La clave no se guarda en ningún sitio y desaparece al recargar la página. Las solicitudes desde la consola gastan créditos como cualquier otra.