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"

データは米国ストアの英語版を基にした400万以上のGoogle Playアプリを対象とし(米国で提供されていないアプリは他の国から取得)、毎晩更新されます。ストアから消えたアプリも、最後のデータとともにデータベースに残ります。

認証

/v1/health を除くすべてのリクエストには、ヘッダーにAPIキーが必要です:

X-API-Key: ak_live_…

以下も利用可能: Authorization: Bearer …。キーをURLパラメータで渡すことはできません。ログやブラウザの履歴に残ってしまうためです。

クレジットと上限

各呼び出しの費用は、レスポンスの行数(最大100)にかかわらず、エンドポイントに応じて0〜3クレジットです。appsの一括呼び出しは1アプリにつき1クレジットです。当月のプランのクレジットが先に使われ、その後プリペイド残高が使われます。当社側の問題でリクエストが失敗した場合、クレジットは返却されます。 プランとパック

残りクレジットは、すべてのレスポンスの _credits フィールドと /v1/account(無料)でも確認できます。

レスポンス形式とエラー

すべてのレスポンスに ok フィールドがあります。リストには results、total、page、per、pages が含まれます。エラー時は ok = false で、error に説明、code に機械可読なコードが入ります。日付はUTCのISO 8601形式です。

{ "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;

試す

キーは アカウントページで作成できます。リクエストはブラウザから直接送信されます。キーはどこにも保存されず、ページを再読み込みすると消えます。 コンソールからのリクエストも通常どおりクレジットを消費します。