GenderAPI.io · REST API v2
قدّر الجنس المرجّح من الاسم الأول أو الاسم الكامل أو عنوان البريد الإلكتروني أو اسم المستخدم. تعيد GenderAPI.io V2 استجابة JSON منظّمة تتضمن مصدر التقدير ودرجة الثقة وسياق الدولة الاختياري.
GenderAPI.io V2
https://api.genderapi.io/api/v2/gender?type=name&value=فاطمةاستجابة V2 حقيقية تم الحصول عليها في 1 أكتوبر 2026. أرسل طلبًا لمشاهدة نتيجة مباشرة.
| الاسم | فاطمة |
|---|---|
| الجنس | أنثى |
| درجة الثقة | 99% |
| الدولة | المملكة العربية السعودية (SA) |
| المصدر | قاعدة بيانات الأسماء |
| الأرصدة المستخدمة | 1 |
{
"data": {
"input": {
"type": "name",
"value": "فاطمة",
"country": null
},
"name": "فاطمة",
"gender": "female",
"country": "SA",
"confidence": 0.9901960784313726,
"confidence_kind": "observed_frequency",
"sample_count": 102,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "فاطمة",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "f7a596d4-0184-4b5e-9fb3-71ca9bd6e2aa",
"duration_ms": 9,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 1,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}تحليل الاسم الأول والاسم الكامل
افحص السجلات واحدًا تلو الآخر، أو أرسل طلبات مجمّعة، أو استخدم أدوات جداول البيانات. يفصل V2 بين النتائج المحدَّدة والنتائج غير المعروفة، ليحتفظ تطبيقك بعدم اليقين بدلًا من فرض تقدير غير مؤكد.
الجنس من الاسم
احصل على نتيجة مع درجة الثقة ومصدر التقدير. وعندما يتعذّر التقدير، يعرض V2 النتيجة بوضوح على أنها غير معروفة.
الجنس من البريد الإلكتروني
اقرأ إشارات الاسم في تنسيقات البريد الإلكتروني الشائعة، وأضف تقدير الجنس ومصدره إلى بيانات CRM والعملاء المحتملين والتحليلات.
الجنس من اسم المستخدم
تعرّف على الأسماء الشائعة داخل أسماء المستخدمين. ومع forceToGenderize يمكنك طلب تقدير للأسماء المستعارة التي لا تتضمن اسمًا حقيقيًا، لكن الحصول على تقدير غير مضمون.
معالجة Excel وCSV
ارفع ملف Excel أو CSV، واختر عمود المصدر، ثم نزّل النتائج. ولإرسال طلبات مجمّعة من تطبيقك، راجع دليل الطلبات المجمّعة في V2.
تكاملات GenderAPI.io
ابدأ بواجهة REST أو اربط GenderAPI.io بجداول البيانات ومنصات التجارة الإلكترونية وخدمات الأتمتة. راجع في كل دليل إصدار API الذي يستخدمه التكامل.
الأسئلة الشائعة
تعرّف على أنواع الطلبات ودرجة الثقة والاستخدام المجاني وتكلفة الأرصدة. وراجع تنسيق الطلب وأمثلة الشيفرة في وثائق V2.
عرض جميع الأسئلةتقدّر GenderAPI.io الجنس المرجّح من الاسم أو عنوان البريد الإلكتروني أو اسم المستخدم. ويعيد V2 في JSON التقدير ودرجة الثقة والمصدر والأرصدة المستخدمة. تستند هذه التقديرات إلى أنماط شائعة في الأسماء، ولا تؤكد الهوية التي يصرّح بها الشخص عن نفسه.
يفحص الطلب الفردي مجموعة البيانات أولًا. وإذا لم يُعثر فيها على تقدير، يُستخدم الذكاء الاصطناعي افتراضيًا. تكلفة هذا الوضع الافتراضي رصيد واحد إجمالًا، بما في ذلك الذكاء الاصطناعي. في الطلبات المجمّعة يكون الذكاء الاصطناعي معطّلًا افتراضيًا. ويمكنك اختيار وضع الذكاء الاصطناعي أو تفعيل forceToGenderize لتحليل الأسماء المستعارة.
في V2 تكون قيمة الحقل confidence بين 0 و1 أو null. ويوضح الحقل confidence_kind ما إذا كانت الدرجة مأخوذة من التكرار المرصود في مجموعة البيانات أو صادرة عن النموذج؛ ودرجة الثقة لا تضمن صحة النتيجة. وعندما يتعذّر التقدير، تتضمن الاستجابة gender: null وresult_status: unknown.
تكلفة طلب V2 العادي رصيد واحد، حتى عند استخدام الذكاء الاصطناعي وحتى عندما لا تتضمن النتيجة الناجحة تقديرًا. وفي وضع الذكاء الاصطناعي always تكون التكلفة رصيدين. ومع forceToGenderize تكون تكلفة التقدير المأخوذ من مجموعة البيانات رصيدًا واحدًا، وإذا احتاج الطلب إلى الذكاء الاصطناعي تصبح التكلفة الإجمالية رصيدين. وفي الطلبات المجمّعة تُحتسب الرسوم لكل عنصر.
نعم. يقبل V2 مع مفتاح API صالح حتى 50 عنصرًا في كل طلب مجمّع، وحتى 10 عناصر في التجربة حسب عنوان IP. لذلك قد يستهلك طلب HTTP واحد عدة أرصدة. ويمكن أيضًا معالجة الملفات الكبيرة عبر أدوات Excel وCSV أو عبر تكاملات أخرى.
من دون مفتاح API يستخدم العرض التوضيحي لـ V2 التجربة حسب عنوان IP، وهي تمنح 10 أرصدة كل 24 ساعة يتشاركها جميع المستخدمين على عنوان IP نفسه. ويمنح الحساب المجاني 200 رصيد يوميًا. هذه حدود للأرصدة وليست عددًا ثابتًا من الطلبات: الأوضاع التي تكلف رصيدين تستهلك الرصيد أسرع.
نعم. يستخدم V1 وV2 مفتاح API نفسه ورصيد الحساب نفسه. وتستمر تكاملات V1 الحالية في العمل. راجع وثائق V2 للتكاملات الجديدة، لأن نقاط النهاية وحقول الاستجابة وتنسيق الأخطاء في V2 تختلف عن V1.
ابدأ التطوير
أنشئ حسابًا، واختبر طلباتك الأولى باستخدام 200 رصيد مجاني يوميًا، ثم عالج ملفات Excel أو CSV عند الحاجة.