Dokumentasi API — BulkChecker

Autentikasi

Semua endpoint memerlukan kunci API di header permintaan.

http

X-API-Key: YOUR_API_KEY

Kunci API tersedia di Konsol pada "Pusat API". Kunci dalam teks polos hanya ditampilkan sekali saat dibuat; simpan segera.

Format Respons

Semua endpoint mengembalikan JSON.

json

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "message": "Task queued.",
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

GET /v1/balance

Dapatkan Saldo

Mengembalikan saldo USDT saat ini untuk akun terautentikasi.

Contoh Respons

json

{ "balance": "5.230000" }

POST /v1/detect

Kirim Pemeriksaan (Array)

Kirim array nomor telepon untuk pemeriksaan. Diproses secara asinkron. Biaya dipotong di muka; nomor yang tidak diperiksa dikembalikan otomatis.

1.000 hingga 2.000.000 nomor per permintaan. Sertakan kode negara, mis. +8613800138000.

Parameter

Field	Tipe	Wajib	Deskripsi
product	string	Ya	Slug produk. Lihat daftar produk.
country	string	Ya	Kode negara ISO 3166-1 dua huruf, misalnya CN atau US.
phones	array	Ya	Array nomor telepon, 1.000 sampai 2.000.000.

Contoh Respons

json

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

POST /v1/detect/file

Kirim Pemeriksaan (Unggah Berkas)

Unggah berkas TXT atau CSV dengan satu nomor per baris, maks 50 MB.

Parameter

Content-Type: multipart/form-data

Field	Tipe	Wajib	Deskripsi
product	string	Ya	Slug produk
country	string	Ya	Kode negara ISO
file	file	Ya	Berkas TXT atau CSV, satu nomor per baris, maks 50 MB.

Contoh Respons

json

{
  "mode": "async",
  "task_id": "qH5rZ7Lp3Wm9",
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

GET /v1/tasks/{task_id}

Status Tugas

Polling tugas hingga status completed atau failed. Interval direkomendasikan: 3–5 detik.

Contoh Respons

json

{
  "task_id": "xKj9aP3qLm7v",
  "status": "completed",
  "progress": 100,
  "product": "whatsapp-active",
  "country": "CN",
  "total": 5000,
  "processed": 5000,
  "valid": 3800,
  "invalid": 1200,
  "unknown": 0,
  "cost_deducted": "0.500000",
  "cost_refunded": "0.000000",
  "result_available": true,
  "result_expires_at": "2026-05-02T10:00:00+00:00",
  "created_at": "2026-05-01T10:00:00+00:00"
}

Status Tugas

status	Deskripsi
pending	Masuk antrean, menunggu resource.
processing	Pemeriksaan sedang berjalan.
completed	Selesai. Hasil siap diunduh.
failed	Eksekusi gagal.

GET /v1/tasks/{task_id}/result

URL Unduhan

Setelah selesai, ambil URL unduh untuk berkas hasil. Berkas disimpan selama 7 hari secara default (dikontrol oleh setting result_retention_days).

Contoh Respons

json

{
  "task_id": "xKj9aP3qLm7v",
  "download_url": "https://api.bulkchecker.io/api/v1/tasks/xKj9aP3qLm7v/download",
  "expires_at": "2026-05-02T10:00:00+00:00",
  "summary": {
    "total": 5000,
    "valid": 3800,
    "invalid": 1200,
    "unknown": 0
  }
}

Kode Kesalahan

Saat gagal, periksa kode status HTTP dan field message.

HTTP	Kesalahan	Solusi
401	Unauthenticated	Pastikan header X-API-Key ada dan valid.
402	Insufficient balance.	Saldo akun tidak cukup. Isi saldo lalu coba lagi.
404	Not found	task_id tidak ada atau milik akun lain.
422	Validasi gagal	Periksa field wajib, format nomor, dan tipe berkas.
429	Too Many Requests	Endpoint deteksi dibatasi 10 request per menit.

Daftar Produk

Gunakan nilai slug di field product saat mengajukan tugas.

Nama produk	Slug
Pemeriksa Nomor Amazon	`amazonValid`
Pemeriksa Email Amazon	`amazonemailValid`
Pemeriksa Nomor Apple ID	`appleidValid`
Pemeriksa Email Apple ID	`appleidEmailValid`
Pemeriksa Nomor BAND	`bandValid`
Pemeriksa Nomor Binance	`binanceValid`
Pemeriksa Email Binance	`binanceEmailValid`
Pemeriksa Nomor CoinW	`coinwValid`
Pemeriksa Email CoinW	`coinwEmailValid`
Pemeriksa Nomor Facebook	`fbValid`
Pemeriksa Email Facebook	`fbemailValid`
Pencarian HLR	`hlr-lookup`
Pemeriksa Nomor HTX	`htxValid`
Pemeriksa Email HTX	`htxEmailValid`
Pemeriksa Nomor iMessage	`imessageValid`
Pemeriksa Nomor Instagram	`instagram`
Pemeriksa Email Instagram	`insEmailValid`
Pemeriksa Nomor KuCoin	`kucoinValid`
Pemeriksa Email KuCoin	`kucoin`
Usia & Gender LINE	`lineGender`
Pemeriksa Nomor LINE	`lineValid`
Number Checker	`linkednAll`
Number Checker	`linkedn`
Pemeriksa Nomor Microsoft	`microsoftValid`
Pemeriksa Nomor RCS	`RCSValid`
Pemeriksa Nomor Signal	`signalValid`
Pemeriksa Nomor Snapchat	`snapchatValid`
Profil Lengkap Telegram	`tgGender`
Pemeriksa Nomor Telegram	`tgValid`
Pemeriksa Aktivitas Telegram	`tgActive`
Pencarian Username TikTok	`tkUsername`
Pemeriksa Nomor Viber	`viberValid`
Pemeriksa Aktivitas Viber	`viberActive`
Profil Lengkap WhatsApp	`wsGender`
Pemeriksa Nomor WhatsApp	`wsValid`
Pemeriksa Aktivitas WhatsApp	`wsActive`
Usia & Gender Zalo	`zaloGender`
Pemeriksa Nomor Zalo	`zaloValid`
Filter Aktivitas Internet	`internet-activity-filter`
Pemeriksa Status Nomor	`phone-status-check`
Deteksi Model Ponsel	`phone-model-detection`
Phone Status Check（CN）	`cnActiveNumber`

Contoh Lengkap

Salin dan jalankan contoh cURL ini — ganti YOUR_API_KEY dan parameter.

1. Lihat saldo

bash

curl -X GET "https://api.bulkchecker.io/api/v1/balance" \
  -H "X-API-Key: YOUR_API_KEY"

2. Kirim pemeriksaan

bash

curl -X POST "https://api.bulkchecker.io/api/v1/detect" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "whatsapp-active",
    "country": "CN",
    "phones": ["+8613800138000", "+8613900139000"]
  }'

3. Unggah berkas

bash

curl -X POST "https://api.bulkchecker.io/api/v1/detect/file" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "product=whatsapp-active" \
  -F "country=CN" \
  -F "file=@/path/to/numbers.txt"

4. Cek status tugas

bash

curl -X GET "https://api.bulkchecker.io/api/v1/tasks/xKj9aP3qLm7v" \
  -H "X-API-Key: YOUR_API_KEY"

5. Ambil URL unduhan

bash

curl -X GET "https://api.bulkchecker.io/api/v1/tasks/xKj9aP3qLm7v/result" \
  -H "X-API-Key: YOUR_API_KEY"