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크레딧입니다. 이번 달 요금제 크레딧이 먼저 사용되고 그다음 선불 잔액이 사용됩니다. 저희 측 문제로 요청이 실패하면 크레딧은 반환됩니다. 요금제 및 팩

남은 크레딧은 모든 응답의 _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;

사용해 보기

키는 계정 페이지에서 만들 수 있습니다. 요청은 브라우저에서 바로 전송됩니다. 키는 어디에도 저장되지 않으며 페이지를 새로고침하면 사라집니다. 콘솔에서 보낸 요청도 일반 요청과 동일하게 크레딧을 사용합니다.