تحديد الجنس من اسم مستخدم أو اسم تسمية

ملخص الطلب

من الاسم المستخدم إلى الاسم المحتمل

تبحث GenderAPI عن إشارات الاسم داخل المُدخل المُقدَّم، ثم تُقدِّم تنبؤًا بالجنس باستخدام أدلة قاعدة البيانات والسياق الوطني، وعند الطلب، تستخدم تنبؤًا مدعومًا بالذكاء الاصطناعي.

Inputsparkling_unicorn

إشارة مُستخرجةSparkling

Predictionأنثى · 92%

MethodPOST

نوع المحتوىapplication/json

Authenticationرمز تأكيد بearer

خيارات الذكاء الاصطناعيAvailable

HDR

الرؤوس المطلوبة في الاتصال HTTP

إذن الطلب

Content-Typeapplication/json

AuthorizationBearer مفتاح API الخاص بك

جسم طلب JSON

المسامات

Parameter	Type	Requirement	Description
`username`	string	مطلوب	اسم المستخدم، أو حساب اجتماعي، أو اسم عرض، أو اسم تلقائي لتحليله.
`country`	string	اختياري	كود دولة من معيار ISO 3166-1 alpha-2، مثل US أو TR، للسياق الإقليمي.
`askToAI`	boolean	اختياري	عندما يكون صحيحًا، يتم استخدام الاعتماد على الذكاء الاصطناعي إذا لم يكن هناك نتيجة في قاعدة البيانات للإسم المُستخرج.
`forceToGenderize`	boolean	اختياري	عندما يكون صحيحًا، يُحاول التنبؤ بشأن الاسم المُستعمل أو المدخلات التي لا تشبه الأسماء المعتادة.

askToAI

استخدم فقط عندما لا يوجد نتيجة في قاعدة البيانات الخاصة بالاسم.

forceToGenderize

يسمح بالمحاولات بالنسبة للعبارات الخيالية، والاسماء المُستوحاة من العلامات التجارية، والاختصارات غير المعتادة.

الثقة مهمة:يمكن أن تكون النتائج المُجبرة عند إشارات اسم غير قوية أو غير بشرية أقل موثوقية. تقييمprobabilityقبل اتخاذ إجراء على التنبؤ.

أمثلة على الكود

إرسال طلب لاسم مستخدم

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

الاستجابة بحالة 200

إشارة مُستخرجة and prediction

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

حقول الاستجابة

Field	Type	Description
`status`	boolean	هل تم إكمال الطلب بنجاح أم لا.
`used_credits`	integer	الاعتمادات المستهلكة في هذا الطلب.
`remaining_credits`	integer	الاعتمادات المتاحة بعد الطلب.
`expires`	integer	وقت انتهاء الحزمة كزمن UNIX.
`q`	string	الاسم الأصلي المُقدَّم في الطلب.
`name`	string	الاسم المحتمل المُستخلص من الاسم المستخدم.
`gender`	string \| null	القيمة المُستندة إلى التنبؤ: ذكر، أنثى أو فارغة.
`country`	string	الرمز الوطني المُستخدَم في التنبؤ.
`total_names`	integer	عدد العينات التي تدعم التنبؤ.
`probability`	integer	مصداقية التنبؤ بالحد المئوي.
`duration`	string	مدة معالجة الخادم.

تreat أسماء المستخدمين كإشارات غير مباشرة

قد يصف اسم مستخدم علامة تجارية أو شخصية أو مفهوم بدلًا من شخص حقيقي. تأكد من أن الإشارة المُستخرجة ذات معنى وحدد حدودًا مقبولة للإحصاء في سياق استخدامك.nameيجب التأكد من أن الإشارة المُستخرجة ذات معنى وتحديد حدود مقبولة للإحصاء في سياق استخدامك.

الدليل التالي

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

طلب متعدد لأسماء المستخدمينمعالجة عدة حسابات في طلب واحد →طلب بريد إلكتروني واحداستخراج اسم من بريد إلكتروني →