POST AI agent ready /v1/gender/estimate

API Deteksi Gender - Memprediksi Gender dari Nama Depan

Memprediksi gender yang dikaitkan dengan nama depan menggunakan model statistik yang dilatih berdasarkan data demografi publik. Mengembalikan "pria" atau "wanita" dengan skor probabilitas (0-1) dan jumlah sampel. Secara opsional, persempit hasil berdasarkan negara untuk akurasi spesifik wilayah.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/gender/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria","country_id":"US"}'

When to use this API

Salam email yang dipersonalisasi

Jika CRM Anda memiliki nama depan namun tidak memiliki kolom gender, gunakan titik akhir ini untuk memprediksi gender dan menghasilkan salam yang sesuai ("Dear Mr. Smith" vs "Dear Ms. Johnson"). Hanya terapkan prediksi dengan probabilitas di atas 0,90 untuk menghindari kesalahan.

Pengayaan demografi survei dan analitik

Perkaya respons survei atau analisis pengguna dengan prediksi gender ketika informasi tidak dikumpulkan secara langsung. Gunakan data tersebut untuk pelaporan agregat mengenai distribusi gender di seluruh basis pengguna, pola penggunaan produk, atau hasil pengujian A/B Anda.

Rekomendasi produk e-commerce

Prediksi gender dari nama depan pemegang akun untuk mempersonalisasi kategori produk default. Menampilkan rekomendasi pakaian, aksesori, atau hadiah yang sesuai dengan prediksi jenis kelamin, sekaligus memberikan opsi mudah bagi pengguna untuk memperbarui preferensi mereka.

Frequently asked questions

Nilai apa yang dikembalikan oleh bidang gender?

Bidang gender menampilkan "laki-laki" atau "perempuan" berdasarkan statistik mayoritas untuk nama tersebut. Untuk nama-nama dengan probabilitas yang hampir sama (misalnya, "Alex"), responsnya mencerminkan mayoritas kecil, dan probabilitasnya akan mendekati 0,50.

Apa yang dimaksud dengan skor probabilitas?

Probabilitas adalah nilai antara 0 dan 1 yang menunjukkan keyakinan. Skor 0,98 berarti 98% orang dengan nama tersebut di kumpulan data mengidentifikasi diri dengan prediksi gender. Skor di bawah 0,60 menunjukkan bahwa nama tersebut sangat unisex.

Apakah country_id mempengaruhi hasil?

Ya. Beberapa nama memiliki asosiasi gender yang berbeda di berbagai negara. "Andrea" sebagian besar adalah perempuan di negara-negara berbahasa Inggris tetapi laki-laki di Italia. Memberikan country_id memberikan prediksi regional yang lebih akurat.

Bagaimana cara menangani prediksi dengan probabilitas rendah?

Untuk prediksi dengan probabilitas di bawah 0,70, perlakukan nama tersebut sebagai nama yang ambigu gender. Gunakan bahasa yang netral gender dalam komunikasi dan pertimbangkan untuk bertanya langsung kepada pengguna daripada berasumsi.

Bisakah saya memprediksi jenis kelamin untuk nama panggilan atau nama pendek?

Ya, jika nama panggilan tersebut cukup umum untuk muncul di kumpulan data. "Mike" akan kembali menjadi laki-laki, "Liz" akan kembali menjadi perempuan. Singkatan yang tidak umum mungkin memiliki jumlah sampel yang lebih sedikit dan prediksi yang kurang dapat diandalkan.

Get your API key

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