توثيق APK API

البدء السريع

عنوان URL الأساسي: https://apkapi.com/api/v1. التسجيل، وأنشئ مفتاح API في حسابك وأرسل طلبك الأول:

وصف API القابل للقراءة آليًا: OpenAPI 3.1 · مجموعة Postman — استورده إلى Postman أو Insomnia أو مولّد عملاء (openapi-generator) للحصول على SDK جاهز للغتك.

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

تغطي البيانات أكثر من 4 ملايين تطبيق على Google Play من المتجر الأمريكي باللغة الإنجليزية (ومن بلد آخر إذا لم يكن التطبيق متاحًا في الولايات المتحدة)، وتُحدَّث كل ليلة. وتبقى التطبيقات التي تختفي من المتجر في قاعدة البيانات مع آخر بياناتها.

المصادقة

يجب أن يتضمن كل طلب عدا /v1/health مفتاح API في الترويسة:

X-API-Key: ak_live_…

يُقبل أيضًا: Authorization: Bearer …. لا يُسمح بتمرير المفتاح في معاملات URL: فسينتهي به الأمر في السجلات وسجل المتصفح.

الأرصدة والحدود

تكلّف كل عملية استدعاء من 0 إلى 3 أرصدة حسب نقطة النهاية، بغض النظر عن عدد الصفوف في الاستجابة (حتى 100)؛ ويكلّف استدعاء apps الجماعي رصيدًا واحدًا لكل تطبيق. تُستخدم أرصدة خطة الشهر الحالي أولًا، ثم الرصيد المدفوع مسبقًا. إذا فشل الطلب بسبب من جانبنا، تُعاد الأرصدة. الخطط والحزم

تجد أرصدتك المتبقية أيضًا في الحقل _credits في كل استجابة وفي /v1/account (مجانًا).

صيغة الاستجابة والأخطاء

تحتوي كل استجابة على الحقل ok. تتضمن القوائم results وtotal وpage وper وpages. عند الخطأ: ok = false، وerror هو الشرح، وcode رمز قابل للقراءة آليًا. التواريخ بصيغة 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. …" }

نقاط النهاية

جميع نقاط النهاية بصيغة GET /api/v1/{name}. التقسيم إلى صفحات: page (من 1) وper (من 1 إلى 100)، حتى النتيجة رقم 10,000. الترتيب: sort + order=asc|desc.

* — معامل إلزامي

أمثلة الشيفرة

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

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

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

// Node.js 18+ (على الخادم، لا في المتصفح)
const res = await fetch("https://apkapi.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://apkapi.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;

جرّب

يمكنك إنشاء مفتاح في حسابك. يُرسل الطلب مباشرة من متصفحك. لا يُخزَّن المفتاح في أي مكان ويختفي بعد إعادة تحميل الصفحة. تستهلك الطلبات من وحدة التحكم الأرصدة مثل غيرها.