Membuat pesanan

1. Pilih pemeriksaCopy Anchor Link

GET /checkers mencantumkan apa yang dapat dipesan akun Anda, dengan harga Anda. Setiap pemeriksa punya id, misalnya whatsapp_status_detection, dan menerima nomor telepon, email, atau nama pengguna. Lihat Pemeriksa.

curl "https://api.talismanleads.io/v1/checkers" \
  -H "Authorization: Bearer tl_live_your_key_here"

2. Kirim daftar AndaCopy Anchor Link

Masukkan hingga 100.000 entri dan 4 MB dalam permintaan sebagai entries. Untuk daftar yang lebih besar, minta tautan ke POST /uploads, kirim file ke tautan itu dengan PUT, lalu gunakan upload_id-nya. Tautan berlaku 2 jam. Jangan kirim kunci API Anda ke tautan itu.

• File berupa .txt dengan satu entri per baris, hingga 200 MB dan 10.000.000 entri.
• Tulis nomor telepon dengan kode negaranya, misalnya +14155550142.
• Nomor telepon dalam satu file sebaiknya dari satu negara: minimal 90% di antaranya. Pisahkan daftar campuran menjadi satu file per negara.
• Satu baris yang tidak valid membuat seluruh daftar ditolak, dan responsnya menampilkan contoh.
• File yang diunggah menunggu pesanan selama 24 jam, lalu dihapus.
• Anda dapat memiliki 20 file atau 100 MB yang menunggu sekaligus, berapa pun jumlah kunci API yang Anda pakai, dan melakukan 500 unggahan per hari. Satu file dengan ukuran apa pun yang diizinkan dapat ditambahkan selama Anda masih di bawah batas itu.

Minta tautan

curl -X POST "https://api.talismanleads.io/v1/uploads" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_name":"list.txt","size_bytes":1048576}'

Kirim file ke tautan itu

UPLOAD_URL="PASTE_upload_url_FROM_THE_ANSWER_ABOVE"
curl --upload-file list.txt "$UPLOAD_URL" \
  -H "Content-Type: text/plain" \
  -w "%{http_code}\n"

3. Lihat harganyaCopy Anchor Link

POST /estimates menghitung entri dan harganya, dan tidak menagih apa pun. billed_entries bisa lebih besar dari entries, karena setiap file ditagih minimal 2.000.

curl -X POST "https://api.talismanleads.io/v1/estimates" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

4. Buat pesananCopy Anchor Link

POST /orders menagih saldo Anda dan memasukkan pekerjaan ke antrean. Kirim Idempotency-Key, agar pengulangan tidak bisa menagih Anda dua kali: lihat Mengulang dengan aman. Untuk memastikan harganya, kirim expected_charge, dan pesanan ditolak dengan price_changed jika biayanya berbeda. Sediakan waktu hingga 5 menit untuk respons, karena daftar besar perlu waktu untuk dibaca.

curl -X POST "https://api.talismanleads.io/v1/orders" \
  -H "Authorization: Bearer tl_live_your_key_here" \
  -H "Idempotency-Key: crm-export-2026-11-05" \
  -H "Content-Type: application/json" \
  -d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'

5. Pantau statusnyaCopy Anchor Link

Panggil GET /orders/{id} setiap 30 detik atau lebih. File besar dibagi menjadi beberapa bagian di balik layar, tetapi satu pesanan punya satu status dan satu total.

queued

Menunggu dimulai.

processing

Sedang berjalan.

completed

Selesai, dan setiap bagian telah dikerjakan.

partially_completed

Selesai, dengan beberapa bagian gagal. Bagian itu dikembalikan dananya: `refunded` menunjukkan jumlah yang kembali.

failed

Tidak ada bagian yang bisa dikerjakan. Tagihannya dikembalikan: `refunded` menunjukkan jumlah yang kembali.

Status baru dapat ditambahkan, jadi perlakukan status yang tidak Anda kenal sebagai masih berjalan.

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer tl_live_your_key_here"

6. Ambil hasilnyaCopy Anchor Link

GET /orders/{id}/results memberikan tautan unduhan untuk setiap bagian, berlaku 15 menit. Minta lagi tautan baru kapan saja: hasilnya disimpan. File biasanya berupa zip yang berisi all.csv, spreadsheet, dan daftar teks, atau satu file CSV. Kolom dapat ditambahkan, jadi baca berdasarkan nama, bukan posisi. Jangan kirim kunci API Anda ke tautan ini.

curl "https://api.talismanleads.io/v1/orders/ord_8f2c1e7a-3b4d-4c5e-9f60-1a2b3c4d5e6f/results" \
  -H "Authorization: Bearer tl_live_your_key_here"

Tagihan dan pengembalian danaCopy Anchor Link

charge adalah biaya pesanan saat Anda membuatnya, dan refunded adalah jumlah yang kembali darinya. Bagian yang gagal dikembalikan penuh, dan bagian yang dihitung kurang oleh penyedia dikembalikan selisihnya, sampai batas minimum tagihan bagian itu. Keduanya terjadi otomatis.

Daftar yang sama pada pemeriksa yang sama dalam waktu sekitar satu hari, dengan Idempotency-Key baru, ditagih lagi sebagai pesanan baru, dan dapat mengembalikan hasil Anda sebelumnya, bukan pemeriksaan baru.

Pesanan dari tempat lainCopy Anchor Link

Pesanan yang Anda buat di situs web juga tercantum. Pesanan API muncul di Tugas saya di situs web dengan lencana API, dan tidak mengirim apa pun ke Telegram kecuali Anda memintanya di sana.