Dokumentasi API

API Reseller

Dokumentasi API Tokosocmed

Hubungkan layanan SMM Tokosocmed ke website, bot, atau panel kamu. Cukup 4 endpoint dengan contoh kode siap pakai di PHP, Python, Node.js, dan cURL.

Base URLhttps://tokosocmed.com/api

Ambil API key Daftar layanan & ID

Mulai cepat

1. Ambil API key
Buka Pengaturan › API lalu salin API key kamu.
2. Pilih layanan
Panggil GET /services untuk ID, harga, min & max.
3. Kirim order
Panggil POST /order, lalu pantau dengan /order/status.

Autentikasi

Setiap endpoint kecuali /services membutuhkan parameter key berisi API key akun kamu. Saldo akun pemilik key yang akan dipotong saat order.

Simpan API key hanya di server. Jangan taruh di kode frontend, aplikasi mobile, atau repository publik. Kalau bocor, segera ganti di Pengaturan › API — key lama langsung tidak berlaku.

Format request & respons

Kirim parameter sebagai application/x-www-form-urlencoded. Semua nilai berupa teks — kirim "100", bukan angka 100 di JSON.
Semua respons berbentuk JSON dengan HTTP status 200, termasuk saat gagal. Selalu cek field error.
Jika error bernilai true, alasan ada di message.

Berhasil

{
  "error": false,
  "…": "data sesuai endpoint"
}

Gagal

{
  "error": true,
  "message": "Saldo tidak cukup"
}

GET/services

Daftar Layanan

Semua layanan aktif beserta harga, minimal & maksimal order. Tidak perlu API key.

Tidak ada parameter.

Contoh request

curl -sS 'https://tokosocmed.com/api/services'

Respons berhasil

200 · application/json

{
  "error": false,
  "data": [
    {
      "id": 1772,
      "name": "Instagram Like Real Indonesia INSTANTT ALWAYS WORK MAX 10k",
      "category": "IG Like, View, & Other",
      "image_url": "https://…/categories/instagram.jpeg",
      "description": "PASTIKAN JUMLAH LIKE HARUS DITAMPILIN…",
      "price": "38",
      "min": 50,
      "max": 5000,
      "instruction": "Masukan target dengan link\nMasukan jumlah"
    }
  ]
}

Respons gagal

Method salah
{"error":true,"message":"Method not supported"}

price adalah harga per 1 unit dalam Rupiah (string). Harga per 1.000 = price × 1000.
Harga untuk order via API bisa berbeda dari harga di website. Biaya final selalu ada di field charge saat membuat order.
Simpan (cache) hasilnya, misalnya 1 jam, lalu ambil ulang — layanan & harga bisa berubah.

POST/order

Buat Order

Membuat pesanan baru. Saldo akun langsung dipotong sebesar charge.

Parameter	Wajib	Keterangan	Contoh
key	Ya	API key akun kamu. Ambil di Pengaturan › API.	API_KEY_KAMU
service	Ya	ID layanan dari /services.	1772
target	Ya	Link postingan / profil / username sesuai layanan.	https://www.instagram.com/p/C7oSUZpp-zy/
quantity	Ya	Jumlah yang dipesan, antara min dan max layanan.	100
note	Opsional	Catatan tambahan untuk pesanan (opsional).	-

Contoh request

curl -sS -X POST 'https://tokosocmed.com/api/order' \
  --data-urlencode 'key=API_KEY_KAMU' \
  --data-urlencode 'service=1772' \
  --data-urlencode 'target=https://www.instagram.com/p/C7oSUZpp-zy/' \
  --data-urlencode 'quantity=100'

Respons berhasil

200 · application/json

{
  "error": false,
  "order": 2347836,
  "service": "Instagram Like Real Indonesia INSTANTT ALWAYS WORK MAX 10k",
  "charge": 3800
}

Respons gagal

API key salah
{"error":true,"message":"ERROR INVALID USER ID OR API KEY"}
Saldo kurang
{"error":true,"message":"Saldo tidak cukup"}
Jumlah di bawah minimal
{"error":true,"message":"Minimum Jumlah :50"}
Layanan tidak aktif / ID salah
{"error":true,"message":"SERVICE TIDAK DI TEMUKAN"}

Simpan nilai order — itu ID pesanan untuk cek status.
Layanan komentar: tulis satu komentar per baris di target; jumlah dihitung otomatis dari banyaknya baris.
Layanan paket: quantity selalu dihitung 1.
Jangan order ulang ke target yang sama sebelum pesanan pertama selesai.

POST/order/status

Cek Status Order

Status terbaru satu pesanan milik akun kamu.

Parameter	Wajib	Keterangan	Contoh
key	Ya	API key akun kamu. Ambil di Pengaturan › API.	API_KEY_KAMU
order	Ya	ID pesanan dari respons Buat Order.	2347836

Contoh request

curl -sS -X POST 'https://tokosocmed.com/api/order/status' \
  --data-urlencode 'key=API_KEY_KAMU' \
  --data-urlencode 'order=2347836'

Respons berhasil

200 · application/json

{
  "error": false,
  "status": "Processing",
  "start": 1200,
  "remains": 350
}

Respons gagal

ID salah / bukan milik akun / API key salah
{"error":true,"message":"no result"}

start = jumlah awal di target saat pesanan mulai, remains = sisa yang belum terkirim.
Cek tiap 5–15 menit. Pesanan umumnya selesai 5–7 hari, paling lama 14 hari.

POST/info

Informasi Akun

ID, username, dan saldo akun pemilik API key.

Parameter	Wajib	Keterangan	Contoh
key	Ya	API key akun kamu. Ambil di Pengaturan › API.	API_KEY_KAMU

Contoh request

curl -sS -X POST 'https://tokosocmed.com/api/info' \
  --data-urlencode 'key=API_KEY_KAMU'

Respons berhasil

200 · application/json

{
  "error": false,
  "data": {
    "id": 12345,
    "username": "rezals00",
    "balance": 330594
  }
}

Respons gagal

API key salah
{"error":true,"message":"no result"}

Cocok untuk cek saldo sebelum order otomatis.

Status order

Pending	Pesanan diterima dan menunggu diproses.
Processing	Pesanan sedang dikirim ke target.
Completed	Pesanan selesai.
Partial	Hanya sebagian terkirim. Sisa yang tidak terkirim otomatis dikembalikan ke saldo.
Canceled	Pesanan dibatalkan dan dana dikembalikan ke saldo.

Status akhir: Completed, Partial, Canceled. Berhenti polling setelah salah satunya muncul.

Kode error

message	Penyebab	Solusi
ERROR INVALID USER ID OR API KEY	API key salah atau sudah diganti (endpoint /order).	Salin ulang API key dari Pengaturan › API.
no result	API key salah, atau ID order tidak ditemukan di akun kamu (endpoint /info, /order/status).	Periksa API key dan ID order.
SERVICE TIDAK DI TEMUKAN	ID layanan salah atau layanan sedang nonaktif.	Ambil ulang daftar dari /services.
Saldo tidak cukup	Saldo kurang dari biaya order.	Isi saldo lalu kirim ulang.
Minimum Jumlah :… / Maximum Jumlah :…	quantity di luar batas min/max layanan.	Sesuaikan quantity dengan min & max dari /services.
Method not supported	HTTP method salah.	Gunakan GET untuk /services dan POST untuk endpoint lain.
[{ "code": "invalid_type", … }]	Parameter wajib kosong atau dikirim bukan sebagai teks (mis. angka di body JSON).	Kirim semua parameter sebagai form-urlencoded string.

Contoh integrasi lengkap

Cek saldo → cari layanan → buat order → pantau status sampai selesai. Ganti API_KEY_KAMU dengan API key kamu.

API_KEY="API_KEY_KAMU"

# 1. Cek saldo
curl -s -X POST 'https://tokosocmed.com/api/info' --data-urlencode "key=$API_KEY"

# 2. Daftar layanan (contoh memakai jq untuk merapikan)
curl -s 'https://tokosocmed.com/api/services' | jq '.data[] | {id, name, price, min, max}'

# 3. Buat order
curl -s -X POST 'https://tokosocmed.com/api/order' \
  --data-urlencode "key=$API_KEY" \
  --data-urlencode 'service=1772' \
  --data-urlencode 'target=https://www.instagram.com/p/C7oSUZpp-zy/' \
  --data-urlencode 'quantity=100'

# 4. Cek status (ganti 2347836 dengan nilai "order" dari langkah 3)
curl -s -X POST 'https://tokosocmed.com/api/order/status' \
  --data-urlencode "key=$API_KEY" \
  --data-urlencode 'order=2347836'

Tips integrasi

Cache hasil /services (mis. 1 jam). Harga dan ketersediaan bisa berubah, jadi ambil ulang secara berkala.
Simpan ID order dari respons Buat Order bersama data pelanggan kamu.
Cek status tiap 5–15 menit, jangan lebih sering. Pesanan umumnya selesai 5–7 hari, paling lama 14 hari.
Gunakan nilai charge dari respons order sebagai biaya final — harga API bisa berbeda dari harga di website.
Cek saldo lewat /info sebelum order otomatis dalam jumlah besar.
Jangan kirim order kedua ke target yang sama sebelum order pertama selesai.

Butuh bantuan integrasi? Chat CS 24/7.“Halo min, saya mau tanya tentang integrasi API Tokosocmed”