الجنسية من الاسم: ما يمكن أن يقوله الاسم وما لا يقوله
نداء API واحد يحوّل اسمًا أول أو اسم عائلة إلى قائمة مرتَّبة بالبلدان التي جاء منها، مع احتمال لكل منها. إنه يجيب عن سؤال حول الاسم — وهو سؤال مختلف عن مكان سكن الشخص، ومختلف أكثر عن هوية الشخص
الجواب المختصر
- تحصل على قائمة مرتَّبة تصل إلى 25 بلدًا، مع احتمال لكل منها ورمز ISO واسم البلد، وحيث تكون مسجَّلة للبلد، منطقته القارية والإحصائية
- تحمل الاستجابة نفسها أيضًا الجنس ولغة الأصل ومعنى الاسم وتوزيعه بين الجماعات العرقية، من قاعدة بيانات تغطي 192 بلدًا
- يكلّف 2 credits لكل اسم — ضعف استعلام الجنس العادي، لأنه استعلام أثقل. تُشترى الـ credits مسبقًا ولا تنتهي صلاحيتها
- هذا إحصاء عن الاسم، لا ادعاء عن الشخص. استخدمه للمخاطبة والتحليل المجمَّع وجودة البيانات — لا لتقرير أي شيء بشأن فرد بعينه
من أين يأتي هذا الرقم؟
لا يوجد هنا نموذج يخمّن، ولا شيء يُولَّد. الاحتمال حساب على سجلات نملكها فعلًا — ولهذا يُرجع الاسم نفسه القائمة نفسها اليوم والشهر المقبل والعام المقبل
تدخل إشارتان. الأولى هي كيف تتوزع سجلات ذلك الاسم بين البلدان — اسم نملكه أساسًا من بولندا يميل إلى البولندية. والثانية هي حجم كل من تلك السكانيات، وهي تمنع بلدًا صغيرًا يحمل اسمًا جيّد التمثيل من تجاوز بلد كبير بالحجم وحده. يُؤخذ متوسط الاثنتين لكل بلد، ويُستبعد كل ما هو أقل من واحد في المئة، ويُرتَّب ما يبقى
لأنه توزيع، فإن اسمًا شائعًا في بلدين يجيب ببلدين بدلًا من اختيار فائز. وهذا هو الجزء المفيد بالضبط: شكل القائمة يخبرك بمقدار الثقة الممكنة في المدخل الأول
ما يُرجَع
طلب POST واحد، اسم واحد، استجابة واحدة. القائمة أدناه مختصرة؛ والحقيقية تمتد إلى أرجح 25 بلدًا
POST https://gender-api.com/v2/country-of-origin
{ "first_name": "Johann" }
{
"result_found": true,
"first_name": "Johann",
"gender": "male",
"probability": 0.9,
"language_of_origin": "Germanic",
"meaning": "…",
"country_of_origin": [
{
"country_name": "Germany",
"country": "DE",
"probability": 0.52,
"continental_region": "Europe",
"statistical_region": "Western Europe"
},
{
"country_name": "Austria",
"country": "AT",
"probability": 0.48,
"continental_region": "Europe",
"statistical_region": "Western Europe"
}
],
"ethnicity": {
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"distribution": [ … ]
},
"details": { "credits_used": 2, "samples": 890, "duration": "414ms" }
}
لاحظ الحقلين الذين يجعلان الجواب قابلًا للتدقيق: samples يخبرك على كم سجل يستند الجواب، و credits_used يؤكد الـ credits الاثنين. الاستجابة القائمة على عدد قليل من العيّنات لا تُخفى عنك
- يتيح لك continental_region و statistical_region تجميع القائمة على مستوى المنطقة دون صيانة مخطط ربط خاص بك
- تتضمن الاستجابة أيضًا رابطًا لخريطة تفاعلية لذلك الاسم — وهي أسرع طريقة للتحقق من نتيجة بالعين
- كل حقل موثَّق في مرجع v2
الأصل ليس محل الإقامة
هذا أشيع سوء فهم على الإطلاق، ويحدث في الاتجاهين. حقلان مختلفان، ومعنيان مختلفان، واتجاهان متعاكسان
| السؤال | البلد الذي ترسله | البلد الذي تستعيده |
|---|---|---|
| حقل | country, locale, ip |
country_of_origin |
| المعنى | أين يوجد الشخص الآن | من أين جاء الاسم |
| يغيّر جواب الجنس | نعم — Andrea اسم رجل في إيطاليا واسم امرأة في ألمانيا | لا — إنه خرج، لا دخل |
| عادةً تعرفه سلفًا | نعم — من عنوان الشحن أو النطاق أو عنوان IP | لا — هذا بالضبط ما تشتريه |
| Credits | مجانًا — معامل، لا استعلام | 2 لكل اسم |
ما ليس هو
الاسم دليل عن اسم. ومعاملته كدليل عن شخص هي الموضع الذي يزلّ فيه هذا النوع من البيانات، ولذلك يستحق الأمر الصراحة بشأن الحدود قبل أن تبني عليه شيئًا
قد يكون شخص اسمه Nguyen مولودًا في ملبورن، وقد لا يكون شخص اسمه Smith قد وطئ بلدًا ناطقًا بالإنجليزية قط. تجيب نقطة النهاية عن «من أين جاء هذا الاسم»، وهذا هو السؤال الوحيد الذي تجيب عنه
- ليست جنسية، ولا مواطنة، ولا مكان ميلاد — ولا دليلًا على أي منها
- ليست الانتماء العرقي للشخص. التوزيع العرقي يصف كيف ينتشر الاسم بين الجماعات، وهي خصيصة من خصائص الاسم
- لا ينبغي أن تقرر شيئًا بشأن فرد بعينه — لا سعرًا، ولا طلب تقديم، ولا درجة مخاطرة. البيانات التي تشير إلى الأصل العرقي فئة خاصة بموجب المادة 9 من GDPR، وذلك القرار قرارك كمراقب للبيانات، لا قرارنا
- ليست تخمينًا. حيث نملك القليل جدًا، تكون قيمة result_found هي false ويقول عدد العيّنات ذلك — بدل اختلاق بلد معقول لتعبئة الحقل
من جانبنا: نحن شركة ألمانية، وجميع الخوادم في ألمانيا، وتُعالج البيانات داخل الاتحاد الأوروبي، ويمكن طلب اتفاقية معالجة البيانات من حسابك. الصورة الكاملة في نظرة عامة على الخصوصية
فيمَ يُستخدم فعلًا
- إصابة المخاطبة الصحيحة. معرفة أن اسمًا إيطالي وليس ألماني هي ما يحوّل «Andrea» من التحية الخطأ إلى التحية الصحيحة — واستعلام الجنس في الاستجابة نفسها هو الجزء الذي ينفّذ ذلك
- تحليل السوق والجمهور على المستوى المجمَّع. إلى أي لغة تُترجم حملة، وأي المناطق تصل إليها قائمة بريدية فعلًا، وأين نمت قاعدة العملاء
- جودة البيانات. القائمة التي يتغيّر فيها شكل توزيع الأصل فجأة تعني عادةً أن استيرادًا أخفق، لا أن الجمهور انتقل
- البحث والدراسات السكانية، حيث يكون التوزيع على مستوى الأسماء لفوج كامل وحدة التحليل ولا يُستخلص أي استنتاج عن الأفراد
- النقل الحرفي والمطابقة، حيث تضيّق معرفة الأصل المرجَّح لاسم دائرة هجاءاته المحتملة
تشغيله على قائمة كاملة
الصيغة الدفعية تستقبل حتى 100 اسم في كل طلب، دون حد أعلى لعدد الطلبات. والحِمل مصفوفة JSON مجرَّدة
POST https://gender-api.com/v2/country-of-origin
[
{ "first_name": "Johann" },
{ "full_name": "Andrea Rossi" }
]
- يعمل الاسم الكامل أو عنوان البريد الإلكتروني بدلًا من الاسم الأول — يُستخرج الاسم أولًا، ثم يُحدَّد الأصل
- عملاء رسميون لـ PHP وPython وNode وJava وGo وRuby وRust وPerl و.NET.
- لقائمة لمرة واحدة بدل التكامل، انظر استعلام الجنس بالجملة — الـ credits نفسها، ودون كود
- كل حقل وكل خطأ ووصف OpenAPI: مرجع v2
أسئلة متكررة
هل يمكن معرفة جنسية شخص من اسمه؟
لا، ولا تستطيع ذلك أي خدمة أمينة. ما تحصل عليه هو أين يظهر الاسم وبأي قوة، مرتَّبًا حسب البلد — إحصاء عن الاسم، لا واقعة عن الشخص الذي يحمله. كثيرون يحملون اسمًا لا علاقة لأصله بمكان ميلادهم
ماذا تُرجع نقطة النهاية؟
قائمة مرتَّبة تصل إلى 25 بلدًا، مع احتمال لكل منها ورمز بلد ISO واسم البلد و — حيث تكون مسجَّلة للبلد — منطقته القارية والإحصائية. تحمل الاستجابة نفسها أيضًا الجنس ولغة الأصل ومعنى الاسم وتوزيعه بين الجماعات العرقية
كيف يُحسب الاحتمال؟
من إشارتين: ما نسبة السجلات التي نملكها لهذا الاسم والقادمة من كل بلد، وحجم كل من تلك السكانيات. يُؤخذ متوسط الاثنتين لكل بلد، وتُستبعد البلدان عند واحد في المئة أو أقل، ويُرتَّب الباقي. كل قيمة هي حصة من الكل وليست درجة للبلد بمفرده — لذا اقرأها في مقابل بعضها. لن يكون مجموعها 1 بالضبط: كل ما هو أقل من واحد في المئة يبقى خارجًا، وكذلك كل ما يأتي بعد البلد الخامس والعشرين
كم يكلّف استعلام بلد الأصل؟
اثنان credits لكل اسم، لأنه استعلام أثقل من استعلام الجنس العادي. تبدأ الـ credits من €0.35 لكل 1000، وتُشترى مسبقًا، ولا تنتهي صلاحيتها
هل هذا نفس معامل country الذي أرسله؟
لا — الاتجاهان متعاكسان. ما ترسله من country أو locale أو ip يصف أين يوجد الشخص الآن، ويغيّر أي جنس يُرجع. أما بلد الأصل الذي تستعيده فيصف من أين جاء الاسم، ولا يتوقف على مكان سكن الشخص
هل يمكن تمرير قائمة كاملة عبره؟
نعم. النسخة الدفعية تستقبل حتى 100 اسم في كل طلب، دون حد أعلى لعدد الطلبات، وتجيب نقطة النهاية نفسها على اسم واحد بالجودة ذاتها
هل استنتاج الأصل من الاسم مشروع بموجب GDPR؟
هذا يتوقف على ما تفعله به، وهو قرارك كمراقب للبيانات، لا قرارنا. البيانات التي تشير إلى الأصل العرقي فئة خاصة بموجب المادة 9، لذا استخدامها لاتخاذ قرارات بشأن أفراد محدَّدين يحتاج أساسًا قانونيًا يمكنك إظهاره. التحليل المجمَّع والمخاطبة الصحيحة هما الاستخدامان المعتادان. نحن شركة ألمانية، وجميع الخوادم في ألمانيا، ويمكن طلب اتفاقية معالجة البيانات من حسابك
جرّبه على أسماء تعرفها سلفًا
100 استعلام مجاني في الشهر، دون بطاقة ائتمان. ابدأ بأسماء يمكنك التحقق من أصلها بنفسك — فهي أسرع طريقة لترى ما يقوله لك التوزيع