Τεκμηρίωση APK Surge

Γρήγορη εκκίνηση

Βασική διεύθυνση: https://apksurge.com/api/v1. Εγγραφείτε, δημιουργήστε ένα κλειδί API στον λογαριασμό και στείλτε το πρώτο σας αίτημα:

Περιγραφή του API για μηχανές: OpenAPI 3.1 · συλλογή Postman — εισαγάγετέ το στο Postman, στο Insomnia ή σε γεννήτρια πελατών (openapi-generator) και θα λάβετε έτοιμο SDK για τη γλώσσα σας.

curl -H "X-API-Key: ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ" "https://apksurge.com/api/v1/app?id=com.whatsapp"

Τα δεδομένα αφορούν πάνω από 4 εκατ. εφαρμογές Google Play από την αμερικανική βιτρίνα στα αγγλικά (αν η εφαρμογή δεν υπάρχει εκεί, από άλλη χώρα), με ανανέωση κάθε νύχτα. Οι εφαρμογές που εξαφανίζονται από το κατάστημα παραμένουν στη βάση με τα τελευταία τους δεδομένα.

Εξουσιοδότηση

Κάθε αίτημα, εκτός από το /v1/health, πρέπει να περιλαμβάνει το κλειδί API σε κεφαλίδα:

X-API-Key: ak_live_…

Γίνεται δεκτό επίσης: Authorization: Bearer …. Δεν επιτρέπεται η αποστολή του κλειδιού σε παραμέτρους URL: θα κατέληγε στα logs και στο ιστορικό του προγράμματος περιήγησης.

Tokens και όρια

Κάθε κλήση κοστίζει 0–3 tokens ανάλογα με το endpoint, ανεξάρτητα από τον αριθμό των γραμμών στην απάντηση (έως 100)· το μαζικό αίτημα apps κοστίζει 1 token ανά εφαρμογή. Πρώτα καταναλώνονται τα μηνιαία tokens και μετά τα αγορασμένα. Αν το αίτημα αποτύχει από δική μας πλευρά, τα tokens επιστρέφονται. Πλάνα και πακέτα

Το υπόλοιπο των tokens υπάρχει επίσης στο πεδίο _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. …" }

Endpoints

Όλα τα endpoints είναι GET /api/v1/{όνομα}. Σελιδοποίηση: 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;

Δοκιμή

Μπορείτε να δημιουργήσετε κλειδί στον λογαριασμό. Το αίτημα στέλνεται απευθείας από το πρόγραμμα περιήγησής σας. Το κλειδί δεν αποθηκεύεται πουθενά και εξαφανίζεται μετά την ανανέωση της σελίδας. Τα αιτήματα από την κονσόλα καταναλώνουν tokens όπως όλα τα υπόλοιπα.