# Gender API لتقدير الجنس من الاسم والبريد الإلكتروني واسم المستخدم

> قدّر الجنس المرجّح من الاسم الأول أو الاسم الكامل أو عنوان البريد الإلكتروني أو اسم المستخدم. تعيد GenderAPI.io V2 استجابة JSON منظّمة تتضمن مصدر التقدير ودرجة الثقة وسياق الدولة الاختياري.

Canonical HTML: https://www.genderapi.io/ar

Last reviewed: 2026-09-29

## نظرة عامة

قدّر الجنس المرجّح من الاسم الأول أو الاسم الكامل أو عنوان البريد الإلكتروني أو اسم المستخدم. تعيد GenderAPI.io V2 استجابة JSON منظّمة تتضمن مصدر التقدير ودرجة الثقة وسياق الدولة الاختياري.

## جرّب طلب الاسم في V2

تكلفة كل طلب رصيد واحد. إذا لم يُحفظ مفتاح أو لم يُتعرّف على المفتاح، تُستخدم التجربة حسب عنوان IP، وهي تمنح 10 أرصدة كل 24 ساعة يتشاركها جميع المستخدمين على عنوان IP نفسه.

استجابة V2 حقيقية تم الحصول عليها في 1 أكتوبر 2026. أرسل طلبًا لمشاهدة نتيجة مباشرة.

**استجابة تمثيلية، وليست نتيجة استعلام حي**

```json
{
  "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
    }
  }
}
```

- [افتح العرض التجريبي الحي في صفحة HTML](https://www.genderapi.io/ar#name-demo)

## Gender API للأسماء من مختلف أنحاء العالم

افحص السجلات واحدًا تلو الآخر، أو أرسل طلبات مجمّعة، أو استخدم أدوات جداول البيانات. يفصل V2 بين النتائج المحدَّدة والنتائج غير المعروفة، ليحتفظ تطبيقك بعدم اليقين بدلًا من فرض تقدير غير مؤكد.

تختلف التغطية حسب الاسم والدولة: عالمي

درجة الثقة مع مصدرها ومعناها: ‎0–1

النتائج والأرصدة المستخدمة في JSON: V2

عنصرًا في كل طلب مجمّع باستخدام مفتاح API؛ و10 في التجربة حسب عنوان IP: 50

## قدّر الجنس من الاسم الأول أو الاسم الكامل

احصل على نتيجة مع درجة الثقة ومصدر التقدير. وعندما يتعذّر التقدير، يعرض V2 النتيجة بوضوح على أنها غير معروفة.

- الاسم الأول والاسم الكامل

- سياق إقليمي عند معرفة الدولة

- أسماء بالحروف اللاتينية وبأنظمة كتابة أخرى

- [استكشف واجهة الأسماء في V2 ←](https://www.genderapi.io/ar/docs/v2/gender-from-name)

## استفد من إشارات الاسم في عنوان البريد الإلكتروني

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

- عناوين البريد الشخصية والمهنية

- إثراء سجلات CRM

- درجة الثقة والمصدر في الاستجابة

- [استكشف واجهة البريد الإلكتروني في V2 ←](https://www.genderapi.io/ar/docs/v2/gender-from-email)

## حلّل أسماء المستخدمين والأسماء المستعارة

تعرّف على الأسماء الشائعة داخل أسماء المستخدمين. ومع forceToGenderize يمكنك طلب تقدير للأسماء المستعارة التي لا تتضمن اسمًا حقيقيًا، لكن الحصول على تقدير غير مضمون.

- بيانات الشبكات الاجتماعية والمجتمعات

- تحليل اختياري للأسماء المستعارة

- حالة واضحة عند تعذّر التقدير

- [استكشف واجهة اسم المستخدم في V2 ←](https://www.genderapi.io/ar/docs/v2/gender-from-username)

## عالج قوائم الأسماء دفعة واحدة

ارفع ملف Excel أو CSV، واختر عمود المصدر، ثم نزّل النتائج. ولإرسال طلبات مجمّعة من تطبيقك، راجع دليل الطلبات المجمّعة في V2.

- ملفات Excel وCSV

- أعمدة الاسم الأول أو الاسم الكامل أو البريد الإلكتروني

- سياق دولة اختياري

- [اقرأ دليل الطلبات المجمّعة في V2 ←](https://www.genderapi.io/ar/docs/v2/batch)

## ادمج API أو اربطه بأدواتك الحالية

ابدأ بواجهة REST أو اربط GenderAPI.io بجداول البيانات ومنصات التجارة الإلكترونية وخدمات الأتمتة. راجع في كل دليل إصدار API الذي يستخدمه التكامل.

- [عرض جميع التكاملات](https://www.genderapi.io/ar/integrations)

## ما تحتاج إلى معرفته قبل البدء

تعرّف على أنواع الطلبات ودرجة الثقة والاستخدام المجاني وتكلفة الأرصدة. وراجع تنسيق الطلب وأمثلة الشيفرة في وثائق V2.

- [عرض جميع الأسئلة ←](https://www.genderapi.io/ar/frequently-asked-questions)

### ما هي GenderAPI.io؟

تقدّر GenderAPI.io الجنس المرجّح من الاسم أو عنوان البريد الإلكتروني أو اسم المستخدم. ويعيد V2 في JSON التقدير ودرجة الثقة والمصدر والأرصدة المستخدمة. تستند هذه التقديرات إلى أنماط شائعة في الأسماء، ولا تؤكد الهوية التي يصرّح بها الشخص عن نفسه.

### متى يستخدم V2 الذكاء الاصطناعي؟

يفحص الطلب الفردي مجموعة البيانات أولًا. وإذا لم يُعثر فيها على تقدير، يُستخدم الذكاء الاصطناعي افتراضيًا. تكلفة هذا الوضع الافتراضي رصيد واحد إجمالًا، بما في ذلك الذكاء الاصطناعي. في الطلبات المجمّعة يكون الذكاء الاصطناعي معطّلًا افتراضيًا. ويمكنك اختيار وضع الذكاء الاصطناعي أو تفعيل 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 مجانًا؟

من دون مفتاح API يستخدم العرض التوضيحي لـ V2 التجربة حسب عنوان IP، وهي تمنح 10 أرصدة كل 24 ساعة يتشاركها جميع المستخدمين على عنوان IP نفسه. ويمنح الحساب المجاني 200 رصيد يوميًا. هذه حدود للأرصدة وليست عددًا ثابتًا من الطلبات: الأوضاع التي تكلف رصيدين تستهلك الرصيد أسرع.

### هل يعمل مفتاح API الحالي مع V2؟

نعم. يستخدم V1 وV2 مفتاح API نفسه ورصيد الحساب نفسه. وتستمر تكاملات V1 الحالية في العمل. راجع وثائق V2 للتكاملات الجديدة، لأن نقاط النهاية وحقول الاستجابة وتنسيق الأخطاء في V2 تختلف عن V1.

## جرّب GenderAPI.io مجانًا

أنشئ حسابًا، واختبر طلباتك الأولى باستخدام 200 رصيد مجاني يوميًا، ثم عالج ملفات Excel أو CSV عند الحاجة.

- [إنشاء حساب](https://app.genderapi.io/user/register)
- [قراءة الوثائق](https://www.genderapi.io/ar/api-documentation)