Langsung ke konten
POST AI agent ready /v1/nationality/estimate

API Prediksi Kebangsaan - Perkirakan Negara Asal dari Nama

Memperkirakan negara asal yang paling mungkin untuk suatu nama tertentu menggunakan model statistik yang dilatih berdasarkan data demografi global. Mengembalikan serangkaian negara yang diberi peringkat berdasarkan probabilitas dengan kode ISO 3166-1 alpha-2. Berguna untuk lokalisasi, analisis demografi, dan internasionalisasi.

Parameters

stringrequired

Name (first or last) to predict nationality for.

Code examples

curl -X POST https://api.botoi.com/v1/nationality/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Tanaka"}'

When to use this API

Pemilihan lokal dan bahasa otomatis

Ketika pengguna baru mendaftar hanya dengan nama mereka, prediksi kemungkinan negara asal mereka dan atur bahasa antarmuka dan pengaturan lokal sesuai dengan itu. Pengguna bernama "Tanaka" akan melihat bahasa Jepang sebagai bahasa yang disarankan, sehingga tidak perlu melakukan langkah pemilihan manual.

Riset pasar dan analisis audiens

Analisis distribusi kewarganegaraan basis pengguna atau daftar email Anda dengan menjalankan nama melalui titik akhir ini secara batch. Identifikasi negara mana yang paling disukai produk Anda, dan alokasikan anggaran pemasaran ke wilayah dengan peluang tertinggi.

Pra-penyaringan KYC dan verifikasi identitas

Selama orientasi KYC, bandingkan prediksi kewarganegaraan dengan negara tempat tinggal atau negara paspor yang dinyatakan. Ketidakcocokan yang besar bukanlah penipuan, namun dapat memicu langkah verifikasi tambahan dalam model risiko Anda.

Frequently asked questions

Bisakah saya menggunakan nama depan, nama belakang, atau nama lengkap?
Titik akhir berfungsi dengan masukan nama apa pun. Nama belakang (nama keluarga) sering kali menghasilkan tanda kebangsaan yang lebih khas dibandingkan nama depan. Anda dapat memberikan nama depan, nama belakang, atau nama lengkap, meskipun input token tunggal (satu nama dalam satu waktu) cenderung paling akurat.
Apa yang dimaksud dengan skor probabilitas?
Setiap negara dalam respons memiliki probabilitas antara 0 dan 1 yang mewakili kemungkinan bahwa seseorang dengan nama tersebut berasal dari negara tersebut. Probabilitas 0,85 untuk JP berarti 85% orang dengan nama tersebut di kumpulan data berasal dari Jepang.
Berapa banyak negara yang dikembalikan?
Responsnya mencakup hingga 5 negara yang diberi peringkat berdasarkan probabilitas. Hanya negara-negara dengan probabilitas yang tidak dapat diabaikan (di atas ~0,01) yang disertakan. Nama yang sangat terkait dengan satu negara mungkin memberikan hasil yang lebih sedikit.
Mengapa "Tanaka" menampilkan Brasil sebagai pertandingan sekunder?
Brasil memiliki diaspora Jepang terbesar di luar Jepang. Nama seperti "Tanaka" muncul dalam catatan Brasil karena imigrasi Jepang pada awal abad ke-20. Model ini mencerminkan distribusi nama di dunia nyata di berbagai negara.
Apakah namanya dinormalisasi sebelum diproses?
Ya. Nama ditulis dengan huruf kecil dan diberi spasi. Tanda diakritik dipertahankan dan berkontribusi pada prediksi, karena karakter beraksen membawa sinyal kebangsaan (misalnya, "Muller" vs "Mueller").

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.