เอกสาร APK Surge

เริ่มต้นอย่างรวดเร็ว

URL หลัก: https://apksurge.com/api/v1. สมัครใช้งาน สร้างคีย์ API ใน บัญชีของคุณ แล้วส่งคำขอแรกของคุณ:

คำอธิบาย API สำหรับเครื่องอ่าน: OpenAPI 3.1 · คอลเลกชัน Postman — นำเข้าใน Postman, Insomnia หรือตัวสร้างไคลเอนต์ (openapi-generator) แล้วคุณจะได้ SDK สำเร็จรูปสำหรับภาษาของคุณ

curl -H "X-API-Key: YOUR_KEY" "https://apksurge.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 แบบกลุ่มคิด 1 โทเคนต่อแอป ระบบจะใช้โทเคนรายเดือนก่อน แล้วจึงใช้โทเคนที่ซื้อ หากคำขอล้มเหลวจากฝั่งเรา โทเคนจะถูกคืน แพ็กเกจและแพ็กโทเคน

โทเคนคงเหลือยังอยู่ในฟิลด์ _tokens ของทุกการตอบกลับ และใน /v1/account (ฟรี) ชื่อเก่า _credits และ X-Credits-* เลิกใช้แล้วแต่ยังใช้งานได้

รูปแบบการตอบกลับและข้อผิดพลาด

ทุกการตอบกลับมีฟิลด์ 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 }, … },
  "_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. …" }

เอนด์พอยต์

ทุกเอนด์พอยต์ใช้ 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://apksurge.com/api/v1/app?id=org.telegram.messenger"

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

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

// Node.js 18+ (บนเซิร์ฟเวอร์ — ไม่ใช่ในเบราว์เซอร์)
const res = await fetch("https://apksurge.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://apksurge.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;

ลองใช้

คุณสามารถสร้างคีย์ได้ใน บัญชีของคุณ คำขอถูกส่งตรงจากเบราว์เซอร์ของคุณ คีย์จะไม่ถูกเก็บไว้ที่ใดและจะหายไปเมื่อโหลดหน้าใหม่ คำขอจากคอนโซลใช้โทเคนเหมือนคำขอทั่วไป