تحديد الجنس بالجملة: من عشرة آلاف اسم إلى 10,000,000

ارفع الملف أو استدعِ الواجهة البرمجية. في الحالتين تعرف السعر قبل أن تبدأ، ويعود كل صف مع الدليل الذي يسنده، ويعود جدول بياناتك كما هو جدول بياناتك.

آخر مراجعة 2026-09-01 كتبه ويتابعه فريق Gender-API.com

الجواب المختصر

حتى 10,000,000 صف في ملف CSV واحد، و100,000 في مصنف Excel واحد، أو 100 اسم لكل طلب برمجي دون حد أقصى لعدد الطلبات.
البحث الواحد credit واحد، يُشترى مقدمًا — بدءًا من €0.35 لكل 1,000 اسم. تعرف سعر المهمة كلها قبل أن تبدأها، على فاتورة تتضمن ضريبة القيمة المضافة، والـ credits لا تنتهي صلاحيتها.
مصنفك يُعاد إليك ولا يُستبدل: التنسيقات والتواريخ والمعادلات والخلايا المدمجة والأوراق الأخرى تبقى كلها. والأعمدة الجديدة تُدرج بجانب بياناتك.
كل صف يحمل احتمالًا وعدد عينات، فتستطيع قبول الصفوف الواثقة آليًا وإرسال الباقي فقط إلى المراجعة.

طريقتان للتنفيذ، وكيف تختار

تنظيف لمرة واحدة وقاعدة بيانات تُثرى باستمرار مهمتان مختلفتان. البيانات نفسها تجيب عليهما، لكن لا ينبغي أن تستخدم المسار نفسه لكليهما.

المسارَان لقائمة كبيرة. مسار الرفع يبدأ من ملف CSV أو Excel، ويمر عبر مساعد الرفع حيث تشير إلى العمود الذي يحمل الأسماء، ثم إلى المعالجة في الخلفية، ويخرج بالملف نفسه مع إدراج أعمدة ga_، ويُعلَن اكتماله بالبريد الإلكتروني. ومسار الواجهة البرمجية يبدأ من تطبيقك، ويمر عبر طلب POST إلى نقطة النهاية الجماعية، حتى 100 اسم لكل طلب، ويعيد JSON لكل اسم. وكلاهما يصرف credit واحدًا لكل بحث من الرصيد المدفوع مقدمًا نفسه. — المسارَان والرصيد الذي يتشاركانه

السؤال	رفع ملف	استدعاء الواجهة
الأفضل لأجل	قائمة لديك الآن: تصدير من CRM، قائمة تسجيل في حدث، قائمة بريدية	أسماء تصل باستمرار: تسجيلات، طلبات، عملاء محتملون مستوردون
من ينفذه	أي شخص لديه الملف. بلا كود.	مطوّر، مرة واحدة — ثم يعمل من تلقاء نفسه
حد الحجم	10,000,000 صف لكل ملف CSV، و100,000 لكل مصنف Excel	100 اسم لكل طلب، دون حد إجمالي
ما تستعيده	الملف نفسه، مع إدراج الأعمدة الجديدة	JSON لكل اسم، لتكتبه حيث تشاء
إبلاغه بالبلد	تحديد عمود البلد في المساعد	بلد أو locale أو عنوان IP لكل اسم
أثناء التشغيل	المعالجة تتابع في الخلفية؛ وعند اكتمالها يصلك بريد إلكتروني برابط التنزيل	متزامن — طلب واحد، جواب واحد
التكلفة	متطابقة. credit واحد لكل بحث في الحالتين، من الرصيد نفسه.

ما تكلفه المهمة الكبيرة فعلًا

التسعير لكل بحث، لا لكل مستخدم ولا شهريًا. الاسم الواحد المحلول credit واحد، سواء مرّ بملف أو بالواجهة البرمجية، والسعر يتحسن مع ارتفاع الحجم.

أسماء	أرخص حزمة منشورة تغطي ذلك، صافيًا
10,000	€16.99
100,000	€99.00
500,000	€299
10,000,000	اطلب منا عرض سعر

أمران يستحقان العمل قبل الشراء، لأن كليهما يقلل ما تدفعه: احذف التكرار من القائمة — الاسم نفسه مرتين يكلف credit اثنين — واستبعد الصفوف التي لا تحتاج فعلًا إلى تحديد جنسها. الاسم الذي لا ترسله أبدًا مجاني، وفي تصدير عملاء حقيقي كثيرًا ما تحذف هاتان الخطوتان نسبة مفاجئة من الملف.

المبالغ الحالية وكل الفئات وخيار الاشتراك موجودة في صفحة الأسعار. أكبر من أكبر حزمة منشورة؟ اسألنا — هذا حديث عادي لا حالة خاصة.

جدول بياناتك يعود جدول بيانات

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

جدول بيانات تبقى فيه الأعمدة الأصلية ID وFirst Name وLast Name وCountry دون تغيير، وبجانبها أربعة أعمدة جديدة: ga_first_name وga_gender وga_accuracy وga_samples. Katharina تظهر female بدقة 100 من 88 samples، وBarbara تظهر female بـ 98 من 3,709 samples، وAndrea في إيطاليا تظهر male بـ 100 من 65,535 samples. — مصنف مُثرى. الأعمدة الأصلية كما كانت تمامًا، والجديدة تجلس بجانبها.

التنسيقات وصيغ الأرقام والتواريخ والمعادلات والخلايا المدمجة محفوظة — التاريخ يبقى تاريخًا، والمعادلة لا تزال معادلة.
المصنفات متعددة الأوراق تحتفظ بكل أوراقها. الرفع يتفقد كل ورقة، ويأخذ أول ورقة تحتوي بيانات، ويتيح لك الانتقال إلى غيرها من خلال محدد الأوراق.
صف العناوين ليس مضطرًا أن يكون الصف الأول. يُكتشف تلقائيًا، وإن أخطأ الاكتشاف تنقر على الصف الصحيح في شبكة المعاينة.
نص حر أعلى الجدول، وجدول يبدأ في العمود C، وعناوين أعمدة ناقصة أو مكررة: كلها معالجة، لأن التصديرات الحقيقية تبدو هكذا.

الأعمدة المضافة بجانب بياناتك:

العمود	ما فيه
`ga_gender`	النتيجة. التسميات تختارها أنت — male/female/unknown، أو ذ/أ، أو 1/2، أو أي شيء يتوقعه نظام CRM لديك أصلًا.
`ga_accuracy`	مدى ميل التوزيع المرصود لهذا الاسم إلى جهة واحدة، كعدد صحيح من 0 إلى 100. (وتعيد الواجهة البرمجية الشيء نفسه كاحتمال بين 0 و1.) عمود اختياري.
`ga_samples`	على كم مشاهدة يستند ذلك. عمود اختياري — وهو الذي يجعل النتيجة قابلة للمراجعة.
`ga_first_name`	الاسم الذي حللناه فعليًا — مفيد عندما يكون المدخل اسمًا كاملًا أو عنوان بريد إلكتروني. عمود اختياري.

مساعد الرفع، خطوة بخطوة. جرّبه بملف.

لماذا يزداد وزن عدد العينات مع الحجم

مع عشرة أسماء تستطيع تفقد النتائج بالنظر. ومع مليون لا تستطيع، فيصبح السؤال: على أي الصفوف تقبل أن تتصرف دون تحقق.

ولأن كل صف يحمل احتمالًا وعدد المشاهدات التي تسنده، فأنت من يرسم هذا الخط. وأحد الخطوط الشائعة: اقبل كل ما هو من ga_accuracy 90 وأعلى مع عدد عينات معقول، واحتفظ بالباقي لمراجعة بشرية أو لتحية محايدة. أما البديل — مستوى ثقة واحد يُطبق على قاعدة بياناتك كلها ويختاره شخص آخر — فهو الطريق الذي تنتهي به القائمة إلى مخاطبة الناس خطأً على نطاق واسع.

خمسة صفوف من ملف مُثرى مقيسة على حد ga_accuracy 90 وga_samples 50. Katharina وBarbara وAndrea تتجاوزه وتُستخدم كما هي. وصف بدقة 61 مع 42 samples وصف بلا أي نتيجة يقعان تحته ويُحتجزان للمراجعة. — حد توضيحي؛ الصفوف الثلاثة الأولى هي القيم من الملف أعلاه

الأسماء التي لا تستطيع قاعدة البيانات حلها تترك عمود الجنس فارغًا بدلًا من ملئه بتخمين. ومع 9,124,598 اسم موزعة على 192 بلدًا فهذه نسبة صغيرة من قائمة عادية — لكنها نسبة تراها بنفسك.

إن كانت قائمتك تمتد على عدة بلدان فقل ذلك — الاسم نفسه ليس الجنس نفسه في كل مكان، وكتبنا عن ذلك على حدة.

التنفيذ بالكود

للإثراء المستمر، تستقبل نقطة النهاية الجماعية حتى 100 اسم لكل طلب:

POST https://gender-api.com/v2/gender/by-first-name-multiple
[
    { "first_name": "Sandra", "country": "DE" },
    { "first_name": "Andrea", "country": "IT" }
]

كل مدخل يُجاب عليه على حدة، باحتماله وعدد عيناته وبلده — فالدفعة دفعة حقيقية، لا جواب واحد يُطبق على عدة أسماء.

عملاء رسميون لـ PHP وPython وNode وJava وGo وRuby وRust وPerl و.NET.
مرجع v2 الكامل، ووصف OpenAPI، ومجموعة Postman.
دليل تنفيذ جاهز في /skill.md، إن كنت تفضل تسليم المهمة لمساعد برمجي.
تعمل في جدول بيانات أو في نظام CRM؟ توجد تكاملات جاهزة لـ Excel وGoogle Sheets وShopify وHubSpot وSalesforce وZapier وغيرها.

أسئلة قسم المشتريات

قائمة بأسماء عملاء حقيقيين هي بيانات شخصية، والمهمة الكبيرة تحتاج عادةً موافقة شخص سيسأل عن هذا بالتحديد:

نحن شركة ألمانية؛ وجميع الخوادم في ألمانيا، والبيانات تُعالج داخل الاتحاد الأوروبي.
الملفات المرفوعة تُخزَّن مشفَّرة وتُحذف بعد عشرة أيام — وأبكر إن حذفتها أنت.
يمكنك طلب اتفاقية معالجة البيانات من حسابك
تتضمن سجلات الخادم الاسم المُرسل وتُحفظ مدة 14 يومًا لأسباب محاسبية
كل عملية شراء تنتج فاتورة نظامية تتضمن ضريبة القيمة المضافة، وأرقام الضريبة الأوروبية تُعالج بشكل صحيح
credits الحزم المدفوعة مرة واحدة لا تنتهي صلاحيتها، فتنظيف كبير لمرة واحدة لا يحتاج اشتراكًا.

الصورة الكاملة في ملخص الخصوصية.

أسئلة متكررة

كم اسمًا يمكنني معالجته في المرة الواحدة؟

حتى 10,000,000 صف في ملف CSV واحد، وحتى 100,000 صف في مصنف Excel واحد، و100 اسم لكل طلب عبر الواجهة البرمجية — دون حد أقصى لعدد الطلبات. إن كان أكبر من ذلك، فقسّم الملف أو استدعِ الواجهة في حلقة.

كم تكلف مهمة كبيرة لتحديد الجنس؟

البحث الواحد يكلف credit واحدًا، فالسعر محدد قبل أن تبدأ: أرخص حزمة منشورة تغطي 500,000 اسم تكلف €299 صافيًا. وفوق أكبر حزمة منشورة يصبح الأمر عرض سعر لا سعر قائمة. تشتري الـ credits مسبقًا، ولا تنتهي صلاحيتها، وكل عملية شراء تنتج فاتورة تتضمن ضريبة القيمة المضافة.

هل أحتاج إلى مطوّر؟

لا. ترفع الملف، وتشير إلى العمود الذي يحمل الأسماء، وتنزّل الملف الجاهز — دون سطر برمجي واحد. الواجهة البرمجية موجودة للحالة التي يجب أن يحدث فيها الإثراء باستمرار لا مرة واحدة.

هل يعود ملف Excel كما هو؟

نعم. التنسيقات، وصيغ الأرقام والتواريخ، والمعادلات، والخلايا المدمجة، وكل الأوراق الأخرى تبقى كما كانت؛ فالأعمدة الجديدة تُكتب داخل مصنفك بدلًا من توليد ملف جديد من بياناتك.

ماذا يحدث للصفوف التي لا تستطيع قاعدة البيانات حلها؟

يبقى عمود الجنس فارغًا، وعدد العينات يخبرك بالسبب. ولا يُخمَّن شيء لملء فراغ، فيمكنك تصفية تلك الصفوف وتقرير ما تفعله بها بدلًا من اكتشاف التخمينات لاحقًا.

هل الرفع بالجملة متوافق مع GDPR؟

نحن شركة ألمانية، وجميع الخوادم في ألمانيا، والبيانات تُعالج داخل الاتحاد الأوروبي. الملفات المرفوعة تُخزَّن مشفَّرة وتُحذف بعد عشرة أيام، ويمكنك طلب اتفاقية معالجة البيانات من حسابك.

هل يمكنني التجربة قبل الدفع؟

نعم — كل حساب يتضمن 100 عملية بحث مجانية شهريًا، وهي كافية لتشغيل عيّنة من قائمتك والتحقق من النتائج قبل شراء credits للملف بأكمله.

ابدأ بعيّنة من قائمتك

100 عملية بحث مجانية شهريًا، دون بطاقة ائتمان — تكفي لتشغيل جزء من الملف الحقيقي والتحقق من النتائج قبل أن تدفع عن كامله.

أنشئ حسابًا مجانيًا اطّلع على أسعار الكميات

ارفع ملف CSV أو Excel · توثيق الواجهة البرمجية · اسأل عن حجم أكبر