POST AI agent ready /v1/gender/estimate

API للكشف عن الجنس - توقع الجنس من الاسم الأول

يتنبأ بالجنس المرتبط بالاسم الأول باستخدام نماذج إحصائية مدربة على البيانات الديموغرافية العامة. إرجاع "ذكر" أو "أنثى" مع درجة الاحتمال (0-1) وعدد العينات. يمكنك اختياريًا تضييق النتائج حسب البلد للحصول على دقة خاصة بالمنطقة.

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

تحية البريد الإلكتروني الشخصية

عندما يحتوي نظام إدارة علاقات العملاء (CRM) الخاص بك على الاسم الأول ولكن لا يوجد حقل للجنس، استخدم نقطة النهاية هذه للتنبؤ بالجنس وإنشاء التحية المناسبة ("عزيزي السيد سميث" مقابل "عزيزتي السيدة جونسون"). قم بتطبيق التنبؤات ذات الاحتمالية الأعلى من 0.90 فقط لتجنب الأخطاء.

المسح والتحليلات الإثراء الديموغرافي

إثراء استجابات الاستطلاع أو تحليلات المستخدم بالجنس المتوقع عندما لا يتم جمع المعلومات مباشرة. استخدم البيانات لإعداد تقارير مجمعة حول التوزيع بين الجنسين عبر قاعدة المستخدمين لديك، أو أنماط استخدام المنتج، أو نتائج اختبار A/B.

توصيات منتجات التجارة الإلكترونية

توقع الجنس من الاسم الأول لصاحب الحساب لتخصيص فئات المنتجات الافتراضية. عرض توصيات الملابس أو الإكسسوارات أو الهدايا المتوافقة مع الجنس المتوقع، مع توفير خيار سهل للمستخدمين لتحديث تفضيلاتهم.

Frequently asked questions

ما هي القيم التي يُرجعها حقل الجنس؟

يُرجع حقل الجنس "ذكر" أو "أنثى" استنادًا إلى الأغلبية الإحصائية لهذا الاسم. بالنسبة للأسماء ذات الاحتمالية شبه المتساوية (على سبيل المثال، "Alex")، فإن الاستجابة تعكس الأغلبية البسيطة، وسيكون الاحتمال قريبًا من 0.50.

ماذا تعني درجة الاحتمال؟

الاحتمال هو قيمة بين 0 و 1 تشير إلى الثقة. النتيجة 0.98 تعني أن 98% من الأشخاص الذين يحملون هذا الاسم في مجموعة البيانات يتعرفون على الجنس المتوقع. تشير الدرجات الأقل من 0.60 إلى أن الاسم للجنسين بقوة.

هل يؤثر Country_id على النتائج؟

نعم. بعض الأسماء لها ارتباطات جنسانية مختلفة في بلدان مختلفة. "أندريا" هي في الغالب أنثى في البلدان الناطقة باللغة الإنجليزية ولكنها ذكر في إيطاليا. يوفر توفير Country_id تنبؤات إقليمية أكثر دقة.

كيف يجب أن أتعامل مع التنبؤات ذات الاحتمالية المنخفضة؟

بالنسبة للتنبؤات ذات الاحتمالية الأقل من 0.70، تعامل مع الاسم على أنه غامض بين الجنسين. استخدم لغة محايدة جنسانيًا في الاتصالات وفكر في سؤال المستخدم مباشرة بدلاً من الافتراض.

هل يمكنني التنبؤ بجنس الألقاب أو الأسماء المختصرة؟

نعم، إذا كان اللقب شائعًا بما يكفي للظهور في مجموعة البيانات. سيعود "مايك" ذكرًا، و"ليز" ستعود أنثى. قد تحتوي الاختصارات غير الشائعة على عدد أقل من العينات وتنبؤات أقل موثوقية.

Get your API key

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