Dokumentasi API

Hubungkan panel SMM, bot, atau aplikasi Anda ke Loipedia. Format standar SMM panel (API v2) β€” kompatibel dengan kebanyakan skrip panel.

URLhttps://loipedia.com/api/v2
KeyMasuk untuk melihat API key Masuk

πŸš€ Mulai cepat (5 menit)

  1. Ambil API key di Akun Saya β†’ API Key β†’ πŸ”’ Lihat (verifikasi password + kode). Rahasiakan key β€” siapa pun yang memegangnya bisa order memakai saldo Anda.
  2. Isi saldo lewat menu Deposit. Semua order API memakai saldo akun ini.
  3. Ambil daftar layanan: action=services β†’ simpan service (ID), rate, min, max, type.
  4. Buat order: action=add dengan service, link, quantity β†’ simpan ID order yang dikembalikan.
  5. Pantau status: pasang webhook (disarankan) atau panggil action=status berkala (mis. tiap 5–10 menit, maks. 100 order per panggilan).
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=balance'
Coba dulu action=balance untuk memastikan key benar. Respons: {"balance":"100000.00","currency":"IDR"}

πŸ“¦ Format request & respons

URLhttps://loipedia.com/api/v2 (HTTPS)
MethodPOST saja. GET tidak didukung.
Bodyapplication/x-www-form-urlencoded (standar), multipart/form-data, atau application/json.
AutentikasiParameter key di setiap request (bukan di URL/header).
ResponsSelalu JSON (UTF-8). Gagal β†’ objek berisi error.
AngkaHarga & jumlah dikirim sebagai string (mis. "15000.00", "100") seperti standar panel SMM. Ubah ke angka di sisi Anda.
Mata uangRupiah (IDR). rate adalah harga per 1.000.
Batas120 request / menit per IP. Lebih dari itu β†’ HTTP 429 {"error":"Too many requests"}.
Zona waktutimestamp webhook dalam Unix time (UTC).
Contoh body JSON
curl -X POST https://loipedia.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{
    "key": "API_KEY_ANDA",
    "action": "add",
    "service": 245,
    "link": "https://www.tiktok.com/@user/video/123",
    "comments": ["Mantap kak", "Keren banget", "Sudah follow ya"]
  }'
Pada JSON, comments/usernames boleh berupa array dan orders boleh berupa array angka.

πŸ”Œ Endpoint

semua ke URL yang sama, dibedakan action
Daftar layananaction=services Semua layanan aktif + harga untuk akun Anda.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYaservices
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=services'
Contoh respons berhasil
[
  {
    "service": 101,
    "name": "Instagram Followers Indonesia Refill 30 Hari",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "15000.00",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": false
  },
  {
    "service": 245,
    "name": "TikTok Custom Comments Indonesia",
    "type": "Custom Comments",
    "category": "TikTok Komentar",
    "rate": "90000.00",
    "min": "5",
    "max": "1000",
    "refill": false,
    "cancel": false,
    "group": "TikTok Komentar Indonesia",
    "server": "Server 2"
  }
]
Catatan
  • rate = harga per 1.000 dalam Rupiah, sudah sesuai level akun Anda (member/reseller).
  • type menentukan parameter tambahan saat order β€” lihat tabel Tipe Layanan.
  • refill: true = layanan bergaransi, bisa memakai action=refill.
  • group & server hanya muncul pada layanan yang tersedia di beberapa server (nama layanan sama, server berbeda).
  • Harga & daftar layanan dapat berubah. Sinkronkan minimal 1Γ— sehari dan sebelum menampilkan harga ke pelanggan Anda.
Buat orderaction=add Kirim order baru. Saldo langsung dipotong.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYaadd
serviceintegerYaID layanan dari action=services.
linkstringYaLink / username target. Followers β†’ link profil; likes/views/komentar β†’ link postingan. Lihat Contoh Order.
quantityintegerYaJumlah, antara min–max layanan. Untuk tipe Custom Comments & Mentions Custom List diabaikan (dihitung dari jumlah baris).
commentsstringKondisionalWajib untuk tipe Custom Comments. Satu komentar per baris (pisahkan dengan \n).
usernamesstringKondisionalWajib untuk tipe Mentions Custom List / Mentions with Hashtags. Satu username per baris, tanpa @.
usernamestringKondisionalWajib untuk tipe Comment Likes / Mentions User Followers. Satu username, tanpa @.
answer_numberintegerKondisionalWajib untuk tipe Poll. Nomor pilihan jawaban (1, 2, 3, …).
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=add' \
  --data-urlencode 'service=101' \
  --data-urlencode 'link=https://www.instagram.com/username' \
  --data-urlencode 'quantity=1000'
Contoh respons berhasil
{"order": 23501}
Catatan
  • Simpan nilai order β€” itulah ID untuk cek status & refill.
  • Biaya = rate Γ— quantity Γ· 1000 (dibulatkan ke rupiah terdekat, minimal Rp 1). Diskon jumlah besar (bila ada) dihitung otomatis.
  • Jangan mengirim ulang permintaan yang timeout secara otomatis: order mungkin sudah tercatat. Cek dulu lewat riwayat/status sebelum mencoba lagi.
  • Hindari 2 order berjalan bersamaan ke link & layanan yang sama β€” jumlah bisa tidak masuk penuh dan tidak bisa diklaim.
Kemungkinan error
{"error":"Saldo tidak mencukupi. Harga: Rp …"}Isi saldo dulu.
{"error":"Layanan tidak tersedia."}ID salah / layanan nonaktif. Sinkronkan ulang daftar layanan.
{"error":"Target / link tidak valid."}Link kosong atau format salah.
{"error":"Jumlah harus antara 100 - 10000."}quantity di luar batas min–max.
{"error":"Isi daftar komentar (1 baris = 1 komentar)…"}Tipe Custom Comments tanpa parameter comments.
{"error":"Layanan ini untuk postingan/video, tetapi link yang diisi tampaknya link profil…"}Jenis link tidak cocok (bila pemeriksaan link diaktifkan ketat).
{"error":"Link ini masih punya order yang sedang diproses untuk layanan yang sama…"}Order ganda ditolak (bila diaktifkan ketat).
{"error":"Order gagal diproses provider: … Saldo sudah dikembalikan."}Server menolak order; saldo otomatis kembali.
Status satu orderaction=status Cek status, jumlah awal & sisa.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYastatus
orderintegerYaID order dari action=add.
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=status' \
  --data-urlencode 'order=23501'
Contoh respons berhasil
{
  "charge": "15000.00",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "IDR"
}
Catatan
  • start_count = jumlah target saat order mulai ("0" bila belum diketahui).
  • remains = sisa yang belum terkirim. Jumlah seharusnya kini β‰ˆ start_count + quantity βˆ’ remains.
  • charge = biaya order. Pada status Partial/Canceled, pengembalian dana masuk ke saldo Anda secara terpisah (cek action=balance atau webhook refund).
Kemungkinan error
{"error":"Incorrect order ID"}ID tidak ada atau bukan milik akun Anda.
Status banyak orderaction=status Hingga 100 order sekali panggil.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYastatus
ordersstringYaID order dipisah koma, mis. 23501,23502,23503 (maks. 100).
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=status' \
  --data-urlencode 'orders=23501,23502,99999'
Contoh respons berhasil
{
  "23501": {"charge": "15000.00", "start_count": "3572", "status": "Completed", "remains": "0", "currency": "IDR"},
  "23502": {"charge": "4500.00", "start_count": "120", "status": "Partial", "remains": "300", "currency": "IDR"},
  "99999": {"error": "Incorrect order ID"}
}
Catatan
  • Kunci objek = ID order (string). ID yang tidak valid diberi error tanpa menggagalkan yang lain.
  • Cara paling hemat untuk sinkronisasi berkala: kumpulkan order yang belum final, kirim per 100.
Ajukan refillaction=refill Isi ulang untuk layanan bergaransi.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYarefill
orderintegerYaID order berstatus Completed/Partial dari layanan refill: true.
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=refill' \
  --data-urlencode 'order=23501'
Contoh respons berhasil
{"refill": 812}
Catatan
  • Simpan nilai refill untuk mengecek hasilnya lewat action=refill_status.
  • Bisa diajukan ulang untuk order yang sama setelah 24 jam.
Kemungkinan error
{"error":"Layanan ini tidak bergaransi refill."}refill: false pada layanan.
{"error":"Refill hanya untuk order yang sudah selesai."}Status belum Completed/Partial.
{"error":"Refill hanya bisa diajukan 1x per 24 jam."}Tunggu 24 jam dari pengajuan sebelumnya.
{"error":"Masa garansi refill (30 hari) sudah habis."}Lewat masa garansi layanan.
{"error":"Provider menolak refill: …"}Server tidak menerima refill (mis. jumlah tidak turun).
Status refillaction=refill_status Cek hasil refill.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYarefill_status
refillintegerYaID refill dari action=refill.
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=refill_status' \
  --data-urlencode 'refill=812'
Contoh respons berhasil
{"status": "Completed"}
Catatan
  • Nilai: Pending, In progress, Completed, Rejected. Diperbarui otomatis dari server Β±30 menit sekali.
Kemungkinan error
{"error":"Incorrect refill ID"}ID tidak ada atau bukan milik akun Anda.
Batalkan orderaction=cancel Batalkan order yang belum selesai.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYacancel
ordersstringYaID order, pisahkan dengan koma (maks 50). Layanan harus cancel: true.
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=cancel' \
  --data-urlencode 'orders=23501,23502'
Contoh respons berhasil
[{"order": 23501, "cancel": 1}, {"order": 23502, "cancel": {"error": "Layanan ini tidak mendukung pembatalan."}}]
Catatan
  • cancel: 1 = pembatalan diterima. Order yang belum dikirim ke server langsung Canceled; selebihnya menunggu konfirmasi server.
  • Saldo dikembalikan otomatis: penuh bila Canceled, sesuai sisa bila Partial. Pantau lewat action=status atau webhook.
Kemungkinan error
{"error":"Layanan ini tidak mendukung pembatalan."}cancel: false pada layanan.
{"error":"Order ini sudah tidak bisa dibatalkan (status: …)"}Order sudah selesai/dibatalkan.
{"error":"Server menolak pembatalan: …"}Biasanya karena order sudah mulai diproses.
Cek saldoaction=balance Saldo akun saat ini.
Parameter
NamaWajibKeterangan
keyYaAPI key Anda
actionYabalance
Contoh request
curl -X POST https://loipedia.com/api/v2 \
  -d key=API_KEY_ANDA \
  -d 'action=balance'
Contoh respons berhasil
{"balance": "100000.00", "currency": "IDR"}
Catatan
  • Cek sebelum mengirim order dalam jumlah banyak agar tidak gagal di tengah jalan.

🧩 Tipe layanan & parameter add

type (dari services)ParameterKeterangan
Defaultservice, link, quantityFollowers, likes, views, subscribers, share, dll. Sebagian besar layanan.
Custom Commentsservice, link, commentsKomentar sesuai teks Anda. 1 baris = 1 komentar; quantity = jumlah baris.
Mentions Custom List / Mentions with Hashtagsservice, link, usernamesMention ke daftar username. 1 baris = 1 username.
Comment Likes / Mentions User Followersservice, link, username, quantityLike pada komentar milik username / mention follower dari username.
Pollservice, link, quantity, answer_numberVote polling. answer_number = nomor pilihan.
Packageβ€”Paket khusus, dipesan lewat panel (belum bisa via API).

Nama tipe dicocokkan tanpa membedakan huruf besar/kecil. Bila ragu, lihat contoh isian setiap layanan di halaman Contoh Order.

πŸ”„ Status order

Pending→In progress→CompletedatauPartial/Canceled
PendingOrder diterima, menunggu dikirim ke server. Belum final.
In progressSedang berjalan. remains berkurang bertahap. Belum final.
CompletedFinal. Terkirim penuh. Bisa refill bila layanan bergaransi.
PartialFinal. Terkirim sebagian; dana sisa (remains) otomatis kembali ke saldo.
CanceledFinal. Gagal/dibatalkan server; seluruh biaya kembali ke saldo.

Berhenti mengecek order setelah status final (Completed / Partial / Canceled). Pengembalian dana pada Partial = charge Γ— remains Γ· quantity (dibulatkan), juga dikirim di field refund webhook.

⚠️ Penanganan error

Selalu periksa apakah respons berisi error. Error validasi order dikembalikan dengan HTTP 200 dan pesan dalam Bahasa Indonesia yang bisa langsung ditampilkan ke pelanggan Anda.

{"error":"Missing API key"}HTTP 401 β€” parameter key kosong.
{"error":"Invalid API key"}HTTP 401 β€” key salah, sudah dibuat ulang, atau akun nonaktif.
{"error":"Incorrect request"}HTTP 400 β€” action tidak dikenal atau parameter wajib kosong.
{"error":"Incorrect order ID"}ID order tidak ada / bukan milik akun Anda.
{"error":"Too many requests"}HTTP 429 β€” melebihi 120 request/menit. Tunggu lalu coba lagi.
{"error":"Saldo tidak mencukupi…"}Isi saldo. Lihat error lain per endpoint di bagian Endpoint.

HTTP 5xx / timeout = gangguan sementara. Untuk services, status, balance aman diulang. Untuk add jangan diulang otomatis β€” cek dulu apakah order sudah tercatat.

πŸ“‘ Webhook status order

opsional Β· atur di Akun Saya β†’ API Key

Daripada memanggil action=status berulang, isi URL webhook (wajib HTTPS publik). Setiap status order API Anda berubah, kami mengirim POST JSON ke URL tersebut:

{
  "event": "order.status",
  "order": 23501,
  "status": "Completed",        // Pending | In progress | Completed | Partial | Canceled
  "status_raw": "completed",
  "service": 101,
  "link": "https://www.instagram.com/username",
  "quantity": 1000,
  "start_count": 5210,
  "remains": 0,
  "charge": "15000.00",
  "refund": "0.00",              // dana yang dikembalikan ke saldo (Partial/Canceled)
  "currency": "IDR",
  "timestamp": 1763500000
}
X-Loipedia-Eventorder.status
X-Loipedia-DeliveryID pengiriman unik β€” pakai untuk mencegah proses ganda.
X-Loipedia-Signaturesha256= + HMAC-SHA256(body mentah, secret webhook Anda).
  • Balas dengan HTTP 2xx dalam 8 detik. Bila gagal, dicoba ulang setelah 1, 5, 15 & 60 menit (maks. 5 kali). Riwayat pengiriman tampil di Akun Saya.
  • Urutan kedatangan tidak dijamin β€” abaikan status final yang datang lalu "turun" ke status lebih awal.
  • Tombol Kirim tes di Akun Saya mengirim contoh payload untuk menguji endpoint Anda.
<?php
// verifikasi tanda tangan webhook
$body = file_get_contents('php://input');
$sig  = 'sha256=' . hash_hmac('sha256', $body, 'SECRET_WEBHOOK_ANDA');
if (! hash_equals($sig, $_SERVER['HTTP_X_LOIPEDIA_SIGNATURE'] ?? '')) {
    http_response_code(401);
    exit;
}
$data = json_decode($body, true);
// perbarui order milik Anda yang ID-nya $data['order'] β†’ $data['status']
http_response_code(200);

πŸ’» Contoh kode lengkap

<?php
/**
 * Klien API sederhana β€” simpan sebagai LoipediaApi.php
 */
class LoipediaApi
{
    public function __construct(
        private string $key,
        private string $url = 'https://loipedia.com/api/v2'
    ) {}

    private function call(array $params): array
    {
        $ch = curl_init($this->url);
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => http_build_query(['key' => $this->key] + $params),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 30,
        ]);
        $body = curl_exec($ch);
        $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        if ($body === false) {
            throw new RuntimeException('Koneksi gagal: ' . curl_error($ch));
        }
        $data = json_decode($body, true);
        if (! is_array($data)) {
            throw new RuntimeException("Respons tidak valid (HTTP {$code})");
        }
        return $data;   // cek $data['error'] di pemanggil
    }

    public function services(): array             { return $this->call(['action' => 'services']); }
    public function balance(): array              { return $this->call(['action' => 'balance']); }
    public function status(int $order): array     { return $this->call(['action' => 'status', 'order' => $order]); }
    public function multiStatus(array $ids): array { return $this->call(['action' => 'status', 'orders' => implode(',', $ids)]); }
    public function refill(int $order): array     { return $this->call(['action' => 'refill', 'order' => $order]); }
    public function refillStatus(int $id): array  { return $this->call(['action' => 'refill_status', 'refill' => $id]); }
    public function cancel(array $ids): array     { return $this->call(['action' => 'cancel', 'orders' => implode(',', $ids)]); }

    public function order(int $service, string $link, int $qty, array $extra = []): array
    {
        return $this->call(['action' => 'add', 'service' => $service, 'link' => $link, 'quantity' => $qty] + $extra);
    }
}

// ===== contoh pemakaian =====
$api = new LoipediaApi('API_KEY_ANDA');

$res = $api->order(101, 'https://www.instagram.com/username', 1000);
if (isset($res['error'])) {
    echo 'Gagal: ' . $res['error'];
} else {
    echo 'Order dibuat, ID: ' . $res['order'];
}

// Custom Comments
$api->order(245, 'https://www.tiktok.com/@user/video/123', 0, [
    'comments' => "Mantap kak πŸ‘\nKeren banget\nSudah follow ya",
]);
Ganti API_KEY_ANDA dengan key dari Akun Saya. Jangan menaruh API key di kode yang berjalan di browser/aplikasi pelanggan β€” panggil API dari server Anda.

πŸ› οΈ Memasang di panel SMM Anda

  1. Di admin panel Anda, buka menu Providers / API Providers β†’ Add provider.
  2. Isi API URL: https://loipedia.com/api/v2 dan API Key dari Akun Saya. Pilih tipe API Standard / Perfect Panel / API v2 bila diminta.
  3. Simpan, lalu jalankan sinkronisasi layanan (import services). Atur markup harga jual Anda sendiri.
  4. Pastikan cron status di panel Anda aktif, atau gunakan webhook bila panel mendukung.
  5. Upgrade akun ke Reseller untuk mendapat harga modal lebih murah β€” rate di API otomatis mengikuti.

Belum didukung lewat API: drip-feed (runs/interval), cancel, dan refill massal. Gunakan menu Dripfeed/Langganan & Klaim Refill di panel.

βœ… Praktik terbaik

❓ FAQ API

Apakah ada biaya untuk memakai API?

Tidak. API gratis; Anda hanya membayar order seperti biasa dari saldo.

Kenapa harga di API berbeda dengan di website?

rate mengikuti level akun pemilik key (member/reseller) dan harga terbaru. Sinkronkan ulang daftar layanan bila harga berubah.

Order via API muncul di panel?

Ya. Semua order API tercatat di Riwayat Order akun Anda (sumber: API) dan bisa dilaporkan/refill dari panel juga.

Saya dapat "Invalid API key" padahal sebelumnya jalan.

Key mungkin sudah dibuat ulang (Generate Ulang) atau akun dinonaktifkan. Ambil key terbaru di Akun Saya lalu perbarui di sistem Anda.

Bagaimana mengetahui uang refund?

Dana Partial/Canceled otomatis masuk saldo. Lihat field refund di webhook, perubahan action=balance, atau menu Mutasi Saldo.

Bisa mengirim banyak order sekaligus dalam satu request?

Belum β€” satu add = satu order. Kirim berurutan dengan jeda wajar (batas 120 request/menit). Untuk input massal manual, gunakan menu Mass Order.