پیش‌بینی ملیت افراد از روی نام با API رایگان Nationalize.io

تشخیص ریشه‌ی جغرافیایی و ملیت افراد از روی نام خانوادگی یا نام کامل آن‌ها، یکی از نیازهای کلیدی در تحلیل داده‌های آماری، بازاریابی، و تحقیقات دانشگاهی است. ابزار Nationalize.io یک سرویس قدرتمند و مبتنی بر API است که با بررسی پایگاه داده‌ای شامل بیش از یک میلیارد نفر، احتمال تعلق یک نام به کشورهای مختلف را به صورت درصد و رتبه‌بندی‌شده استخراج می‌کند. این سرویس در کنار ابزارهای مشابه برای تخمین جنسیت و سن (Genderize.io و Agify.io)، امکان تحلیل دقیق جمعیت‌شناختی (Demographic Analysis) را بدون نیاز به پیچیدگی‌های فنی فراهم می‌کند. دقیقاً همان‌طور که در پروژه‌های پردازش داده یا توسعه ابزارهای هوش مصنوعی مانند اجرای ابزارهای هوش مصنوعی به صورت محلی با نرم‌افزار رایگان Pinokio به اتوماسیون نیاز داریم، این سرویس نیز فرآیند غنی‌سازی داده‌ها را سرعت می‌بخشد.

نحوه‌ی کارکرد و دقت پیش‌بینی ملیت

بسیاری از نام‌ها ریشه‌ی مشخصی در کشورهای خاص دارند که همبستگی قوی بین نام و ملیت ایجاد می‌کند. موتور پردازش این سرویس از سیگنال‌های موجود در تمام بخش‌های نام کامل (نام کوچک و نام خانوادگی) استفاده می‌کند تا دقت پیش‌بینی را بالا ببرد. میزان دقت به میزان متمایز بودن نام بستگی دارد؛ برای مثال، نامی مانند «Yamamoto» با دقت بالا به ژاپن متصل می‌شود، در حالی که نام‌های عمومی‌تر ممکن است در چند کشور مختلف پخش شوند. پایگاه داده‌ی این سامانه طی بیش از ۱۲ سال جمع‌آوری شده و بر اساس داده‌های بیش از ۱ میلیارد نفر شکل گرفته است.

شروع کار و دریافت کلید API رایگان

برای استفاده از این سرویس، کافی است یک حساب کاربری رایگان ایجاد کنید. طرح رایگان به شما اجازه می‌دهد تا ماهانه تا ۱۰۰۰ نام را بدون پرداخت هزینه و بدون نیاز به وارد کردن اطلاعات کارت بانکی بررسی کنید. کلید API دریافتی شما در این پنل، دسترسی به سرویس‌های تخمین سن و جنسیت را نیز فراهم می‌کند. این سرویس تضمین می‌کند که هیچ داده‌ای را ذخیره نکرده و قابلیت لغو اشتراک در هر لحظه وجود دارد.

نمونه کد پایتون برای اتصال به API

شما می‌توانید به سادگی و با چند خط کد پایتون، درخواست خود را به این سرویس ارسال کنید. کتابخانه‌های رسمی برای زبان‌های مختلف از جمله پایتون، نود جی‌اس، گو، پی‌اچ‌پی و غیره فراهم شده است. کد زیر نحوه استعلام ملیت یک نام را با استفاده از کتابخانه requests در پایتون نشان می‌دهد:

import requests

def predict_nationality(name):
    url = f"https://api.nationalize.io/?name={name}"
    response = requests.get(url)
    
    if response.status_code == 200:
        data = response.json()
        print(f"نام بررسی شده: {data.get('name')}")
        print("کشورهای احتمالی:")
        for country in data.get('country', []):
            country_id = country.get('country_id')
            probability = country.get('probability') * 100
            print(f"- کشور: {country_id} | احتمال: {probability:.2f}%")
    else:
        print("خطا در ارتباط با سرور:", response.status_code)

# اجرای تابع با یک نمونه نام
predict_nationality("michael")

پس از اجرای این کد، خروجی به صورت JSON دریافت شده و نام کشورها به همراه درصد احتمال (Probability) در ترمینال چاپ می‌شود. برای مثال، برای نام وارد شده، لیستی از کدهای ایزو کشورها (مانند US, GB و غیره) به همراه درصد تناسب نمایش داده خواهد شد.

روش‌های استفاده بدون کدنویسی (No-Code و آپلود فایل)

اگر برنامه‌نویس نیستید یا ترجیح می‌دهید بدون نوشتن کد از این قابلیت استفاده کنید، گزینه‌های متعددی در اختیار شما قرار دارد:

• آپلود فایل (Spreadsheet): می‌توانید فایل‌های اکسل یا CSV حاوی نام‌ها را مستقیماً در مرورگر آپلود کنید تا ستون‌های ملیت، سن و جنسیت به آن‌ها اضافه شده و فایل نهایی را دانلود کنید.
• اتوماسیون ابری: این سرویس دارای نودهای تأییدشده در پلتفرم‌های اتوماسیون مانند n8n و Pipedream است که به شما اجازه می‌دهد جریان‌های کاری خود را بدون کدنویسی بسازید.
• پروتکل کانتکست مدل (MCP): اگر از ابزارهای هوش مصنوعی مانند کلود (Claude)، کورسور (Cursor) یا چت‌جی‌پی‌تی استفاده می‌کنید، می‌توانید این سرویس را به عنوان یک سرور MCP متصل کرده و به صورت زبان طبیعی سوالات جمعیتی بپرسید.

پرسش‌های متداول

جمع‌بندی

ابزار Nationalize.io یک راهکار سریع، سبک و قابل اعتماد برای اضافه کردن لایه تحلیل جمعیت‌شناختی و ملیت به داده‌ها است. چه در حال توسعه یک نرم‌افزار حرفه‌ای با پایتون باشید و چه بخواهید فایل‌های اکسل حاوی اطلاعات مخاطبان خود را بدون کدنویسی غنی‌سازی کنید، طرح رایگان این سرویس تمام نیازهای اولیه‌ی شما را به خوبی پوشش می‌دهد.

ورود به سایت رسمی