← Мировые данные

Демография имени (все)

GET /names/predict/:name

Получение полного демографического прогноза по любому имени, объединяющего оценку возраста, предсказание пола и вероятные национальности в одном ответе. Использует статистические модели, обученные на миллионах записей из государственных баз данных по всему миру. Возвращает предполагаемый возраст, вероятность пола и лучшие совпадения по национальности. Идеально для маркетинговой персонализации, потоков онбординга пользователей, демографических исследований и инструментов аналитики по имени.

Параметры

name обязательный

First name to analyze

Примеры запросов

Базовое использование
curl https://nordapi.ee/api/v1/names/predict/erik
Predict demographics for Erik
curl https://nordapi.ee/api/v1/names/predict/erik
Predict demographics for Yuki
curl https://nordapi.ee/api/v1/names/predict/yuki
Predict demographics for Maria
curl https://nordapi.ee/api/v1/names/predict/maria

Ответ в реальном времени

{
  "data": {
    "name": "erik",
    "predictions": {
      "age": {
        "age": 60,
        "count": 37787,
        "name": "erik"
      },
      "gender": {
        "count": 283166,
        "gender": "male",
        "name": "erik",
        "probability": 0.99
      },
      "nationality": {
        "count": 7458,
        "countries": [
          {
            "country_id": "NO",
            "probability": 0.10713158664039506
          },
          {
            "country_id": "HU",
            "probability": 0.0881305188205663
          },
          {
            "country_id": "DK",
            "probability": 0.05375542272637305
          },
          {
            "country_id": "SE",
            "probability": 0.03872762536610433
          },
          {
            "country_id": "TR",
            "probability": 0.03230662198652821
          }
        ],
        "name": "erik"
      }
    }
  },
  "success": true
}