Tài liệu APK API

Bắt đầu nhanh

URL gốc: https://apkapi.com/api/v1. Đăng ký, tạo khóa API trong tài khoản và gửi yêu cầu đầu tiên:

Mô tả API máy đọc được: OpenAPI 3.1 · Bộ sưu tập Postman — nhập vào Postman, Insomnia hoặc trình tạo client (openapi-generator) để có SDK sẵn sàng cho ngôn ngữ của bạn.

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

Dữ liệu bao gồm hơn 4 triệu ứng dụng Google Play từ cửa hàng Mỹ bằng tiếng Anh (từ quốc gia khác nếu ứng dụng không có ở Mỹ), cập nhật mỗi đêm. Ứng dụng biến mất khỏi cửa hàng vẫn ở lại cơ sở dữ liệu cùng dữ liệu cuối cùng.

Xác thực

Mọi yêu cầu trừ /v1/health đều phải có khóa API trong header:

X-API-Key: ak_live_…

Cũng chấp nhận: Authorization: Bearer …. Không được truyền khóa qua tham số URL: khóa sẽ lọt vào nhật ký và lịch sử trình duyệt.

Tín dụng và giới hạn

Mỗi lần gọi tốn 0–3 tín dụng tùy điểm cuối, bất kể số dòng trong phản hồi (tối đa 100); lần gọi hàng loạt apps tốn 1 tín dụng cho mỗi ứng dụng. Tín dụng gói của tháng hiện tại được dùng trước, sau đó đến số dư trả trước. Nếu yêu cầu lỗi do phía chúng tôi, tín dụng được hoàn lại. Gói và gói tín dụng

Tín dụng còn lại cũng có trong trường _credits của mọi phản hồi và trong /v1/account (miễn phí).

Định dạng phản hồi và lỗi

Mọi phản hồi đều có trường ok. Danh sách chứa results, total, page, per, pages. Lỗi: ok = false, error là phần giải thích, code là mã máy đọc được. Ngày theo 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. …" }

Điểm cuối

Mọi điểm cuối đều là GET /api/v1/{name}. Phân trang: page (từ 1) và per (1–100), đến kết quả thứ 10.000. Sắp xếp: sort + order=asc|desc.

* — tham số bắt buộc

Ví dụ mã

# 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+ (trên máy chủ, không phải trong trình duyệt)
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;

Dùng thử

Bạn có thể tạo khóa trong tài khoản. Yêu cầu được gửi trực tiếp từ trình duyệt của bạn. Khóa không được lưu ở đâu cả và sẽ mất khi tải lại trang. Yêu cầu từ bảng điều khiển cũng dùng tín dụng như các yêu cầu khác.