Produk massal carrier_batch

Pencarian operator global

Unggah satu file berisi nomor: operator, operator dasar, jenis saluran, negara, wilayah, dan kota untuk setiap nomor — kolom yang sama dengan pencarian operator real-time.

Pelengkap untuk daftar besar sekaligus — untuk beberapa nomor saja, pemeriksaan real-time menjawab dalam permintaan yang sama. Pemeriksaan real-time →

Lihat kontrak API Daftar

Kontrak API

Dua langkah: kirim file, lalu periksa tugas

Baca dokumentasi API lengkap Buka Kunci API

Pengiriman langsung mengembalikan ID tugas; periksa tugas dengan ID tersebut dan, setelah berhasil, respons membawa tautan unduhan file hasil. Setiap permintaan ditampilkan bersama responsnya.

1. Kirim file

ID tugas langsung dikembalikan dengan preparing bernilai true selama file disiapkan di latar belakang: baris tidak valid, duplikat, dan — untuk tugas nomor — nomor tanpa kode negara atau dari negara lain dihapus dan tidak ditagihkan. Saldo dicadangkan untuk baris yang dikirim dan diselesaikan saat tugas selesai; selisihnya dikembalikan.

Permintaan cURLPOST /api/v1/bulk-tasks

curl -X POST "https://carrierlookup.online/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=carrier_batch \
  -F country=US \
  -F file=@numbers.txt

Respons: tugas dibuat200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "carrier_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. Periksa tugas

Lakukan polling berdasarkan ID tugas. Setelah persiapan selesai, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, dengan total adalah jumlah yang diperiksa dan ditagihkan. Respons yang berhasil membawa jumlah keberhasilan dan kegagalan serta tautan unduhan file hasil; tugas yang ditolak selama persiapan berstatus failed dengan reason_detail dan dikembalikan sepenuhnya.

Permintaan cURLGET /api/v1/bulk-tasks/{id}

curl "https://carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons: tugas selesai200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "carrier_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Cara kerjanya

Apa yang terjadi pada tugas massal

Massal bukan sekadar real-time dalam skala besar — kirim sekali, berjalan di latar belakang, ambil kemudian. Anda tidak perlu membiarkan halaman tetap terbuka; status tugas dan hasilnya tetap tersimpan di dasbor Anda.

01Unggah file
File .txt atau .csv dengan satu nomor per baris. File langsung dialirkan; tidak ada yang ditulis ke disk.
02Pemeriksaan awal dan pencadangan
Masalah yang jelas (file kosong, format salah, baris terlalu sedikit) ditolak saat diunggah. Saldo kemudian dicadangkan dan file disiapkan di latar belakang: baris duplikat dan tidak valid dihapus dan aturan negara diperiksa. File yang gagal pada tahap itu berakhir sebagai tugas gagal dan dikembalikan sepenuhnya; jika tidak, hanya baris yang tersisa yang diperiksa, dan tugas diselesaikan tagihannya saat selesai.
03Berjalan di latar belakang
Tugas berjalan dengan sendirinya — Anda boleh menutup halaman. Kegagalan langsung dilaporkan dan dikembalikan sepenuhnya.
04Unduh hasilnya
Ambil file dari halaman pemeriksaan massal. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil; selisihnya dikembalikan.

Field hasil

Kolom dalam file hasil

Unduhan berupa satu file CSV dengan tabel hasil lengkap.

Kolom file hasil

identifier · 17253100591 — Nomor yang dikirim dalam bentuk digit polos dengan kode negara, tanpa tanda plus atau spasi (mis. 17253100591).
carrier · T-Mobile — Operator tempat nomor awalnya dialokasikan. Bukan operator saat ini setelah porting.
underlying_carrier — Operator dasar yang dilaporkan penyedia jika berbeda dari operator yang dialokasikan; kosong jika penyedia tidak menyediakannya.
number_type · Fixed Line or Mobile — Jenis saluran yang dilaporkan penyedia, seperti Fixed Line or Mobile; kosong jika tidak tersedia.
country_code · US — Kode negara ISO asal nomor.
region · CA — Wilayah alokasi; kosong jika penyedia tidak menyediakannya.
city · LOS ANGELES — Kota alokasi; kosong jika penyedia tidak menyediakannya.

Paling cocok untuk

Kapan menggunakan produk ini

Segmentasi daftar
Atur seluruh daftar nomor berdasarkan operator asli, jenis saluran, dan negara atau wilayah alokasi dalam file hasil yang dapat diunduh.
Peninjauan biaya routing
Gunakan kolom operator dan wilayah untuk membandingkan catatan routing internal, pengadaan, atau biaya tanpa memeriksa nomor satu per satu.
Kebersihan database
Temukan catatan nomor yang tidak memiliki operator asli, wilayah, atau kota dan buat daftar untuk dilengkapi dan ditinjau manual. Pisahkan catatan yang kosong, tidak lengkap, dan tidak konsisten agar tidak masuk ke analisis berikutnya tanpa disadari.
Alur kerja yang disarankan: tandai catatan untuk ditinjau, ekspor daftar untuk melengkapi data, lalu tulis kembali atau jalankan pencarian lagi.

Jawaban langsung

Apa itu Pencarian operator global massal?

Pencarian operator massal adalah versi file dari pencarian operator real-time, dibuat untuk daftar mulai dari seribu nomor ke atas: unggah file, tugas berjalan di latar belakang, dan Anda mengunduh satu CSV hasil dengan kolom yang sama untuk setiap nomor. Setiap nomor harus menyertakan kode negaranya, dan semua nomor dalam satu file harus berasal dari negara yang Anda pilih saat mengunggah; nomor tanpa kode negara atau dari negara lain dikeluarkan dan tidak ditagih.

Batasan yang jelas

Batasan produk ini

Menggambarkan jaringan tempat nomor awalnya dialokasikan. Tidak mengikuti portabilitas nomor, sehingga belum tentu merupakan operator yang melayani nomor tersebut saat ini.
Ini bukan pemeriksaan keterjangkauan dan bukan verifikasi identitas: hasilnya tidak menyatakan apakah nomor sedang aktif, maupun siapa pemiliknya.
Tidak ada apa pun yang dikirim ke nomor dalam file — pencarian dijalankan terhadap data alokasi.
Hasil mencerminkan data alokasi pada saat tugas dijalankan, dan hasil yang tersimpan tidak pernah diperbarui secara otomatis untuk Anda. Menjalankan file lagi tidak akan menampilkan operator tujuan nomor yang telah dipindahkan.
Tautan unduhan memiliki masa berlaku. Ambil file segera setelah tugas selesai; jika tautan kedaluwarsa, periksa tugas lagi untuk mendapatkan tautan baru.

Kapan massal cocok

Kapan massal sepadan — dan kapan real-time lebih cepat

	Pemeriksaan real-time	Pemeriksaan massal
Berapa banyak nomor	1 nomor per pemeriksaan tunggal; beberapa nomor per permintaan multi — batas pastinya ada di dokumentasi API	Seluruh daftar besar dalam satu tugas — rentang ukuran saat ini ada di halaman harga
Mendapatkan hasil	Langsung: endpoint tunggal dan multi menjawab dalam respons yang sama; dasbor mengembalikannya satu per satu	Unduh file hasil setelah tugas selesai
Negara	Tidak perlu memilih — setiap nomor membawa kode negaranya sendiri, bebas dicampur dalam satu permintaan	Satu negara per tugas, dipilih saat mengunggah dan dikirim bersama file
Bentuk hasil	JSON, field per nomor	File hasil (satu CSV dengan tabel lengkap)
Penggunaan umum	Pengayaan CRM saat input, pencarian oleh agen, aturan routing	Segmentasi daftar, peninjauan biaya routing, kebersihan database

Pemeriksaan real-time · Lihat harga

FAQ produk

Tentang Pencarian operator global

Kapan saya sebaiknya menggunakan massal alih-alih pemeriksaan real-time?

Gunakan massal untuk daftar besar sekaligus. Untuk beberapa nomor saja, pemeriksaan real-time menjawab dalam permintaan yang sama, tanpa tugas yang perlu dijadwalkan.

Apa yang terjadi pada nomor yang tidak valid dalam file?

Pemeriksaan awal membuang baris yang formatnya salah, sehingga tidak pernah masuk ke jumlah yang ditagihkan. Dari nomor yang tersisa, nomor yang tidak dapat diselesaikan oleh layanan hulu juga tidak ditagihkan. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil.

Berapa lama sebuah tugas berlangsung?

Tergantung pada jumlah nomor dan produknya. Anda dapat menutup halaman setelah mengirim; tugas berjalan di latar belakang dan hasilnya menunggu Anda di halaman pemeriksaan massal.

Apakah saya mendapatkan pengembalian dana jika gagal?

Ya. Tugas yang gagal dikembalikan sepenuhnya. Jika tugas berhasil tetapi sebagian nomor tidak mengembalikan apa pun, bagian tersebut dikembalikan secara otomatis. Selisih antara jumlah yang dicadangkan dan yang benar-benar ditagihkan selalu dikembalikan.

Buat akun untuk mengirim tugas massal

Pemeriksaan massal dan real-time menggunakan saldo yang sama — tidak ada yang perlu diaktifkan tambahan. Daftar dan unggah file pertama Anda di halaman pemeriksaan massal.

Daftar Lihat harga

Pencarian operator global

Dua langkah: kirim file, lalu periksa tugas

1. Kirim file

2. Periksa tugas

Apa yang terjadi pada tugas massal

01Unggah file

02Pemeriksaan awal dan pencadangan

03Berjalan di latar belakang

04Unduh hasilnya