تحديد الجنس من البريد الإلكتروني API

نظرة عامة على الطلب

من عنوان البريد إلى التوقع

تحلل GenderAPI الجزء المحلي من العنوان، وتستخرج الاسم الأول الأكثر احتمالاً، ثم تستخدمه لتوقع الجنس. أضف سياق الدولة عندما تعرف منطقة المستخدم.

01إدخال البريدmichael.smith@example.com

02استخراج الاسمMichael

03التوقعmale · 97%

الطريقةPOST

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

المصادقةBearer token

تكلفة الرصيدعملية بحث واحدة

HDR

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

وثّق الطلب

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

جسم طلب JSON

المعاملات

المعامل	النوع	الحالة	الوصف
`email`	string	مطلوب	عنوان البريد الإلكتروني المراد تحليله. تستخرج GenderAPI الاسم الأول الأكثر احتمالاً قبل إجراء التوقع.
`country`	string	اختياري	رمز الدولة ISO 3166-1 alpha-2، مثل US أو TR، لإضافة سياق إقليمي.
`askToAI`	boolean	اختياري	عند ضبطه على true، يُستخدم دعم الذكاء الاصطناعي إذا لم توجد نتيجة للاسم المستخرج في قاعدة البيانات.

دعم الذكاء الاصطناعي

يُقيّم askToAI بعد استخراج الاسم، وفقط عندما لا يوجد الاسم المستخرج في قاعدة البيانات. لا يقبل endpoint البريد الإلكتروني المعامل forceToGenderize.

أمثلة الكود

أرسل طلب بريد إلكتروني

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"michael.smith@example.com","country":"US","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "michael.smith@example.com", country: "US", askToAI: true })
});
const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "michael.smith@example.com", "country": "US", "askToAI": True}
)
print(response.json())

استجابة 200

الاسم المستخرج والتوقع

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "michael.smith@example.com",
  "name": "Michael",
  "gender": "male",
  "country": "US",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

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

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

استخدم عنوان بريد إلكتروني صالحاً وكاملاً

يعتمد استخراج الاسم على بنية العنوان. قد لا تُرجع صناديق البريد العامة أو الأسماء المستعارة أو الأجزاء المحلية التي لا تحتوي على اسم واضح نتيجة؛ تحقّق من name وgender وprobability قبل استخدام التوقع.

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

حلّل عدة عناوين بريد إلكتروني

طلب عدة عناوين بريدعالج عدة عناوين في طلب واحد ←طلب اسم واحدأرسل اسماً أول معروفاً مباشرة ←