← Données mondiales

Démographie des prénoms (complet)

GET /names/predict/:name

Obtenez une prédiction démographique complète pour tout prénom, combinant estimation de l'âge, prédiction du genre et nationalités probables dans une seule réponse. Utilise des modèles statistiques entraînés sur des millions d'enregistrements issus de bases gouvernementales du monde entier. Renvoie l'âge prédit, la probabilité de genre et les principales correspondances de nationalité. Idéal pour la personnalisation marketing, les parcours d'onboarding utilisateur, la recherche démographique et les outils d'analyse fondés sur les prénoms.

Paramètres

name requis

First name to analyze

Exemples de requêtes

Utilisation de base
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

Réponse en direct 

{
  "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
}
← Retour à Données mondiales