← Données mondiales

Démographie des prénoms (complet)

GET /names/predict/:name

Obtenez une liste complète demographic prediction pour tout first name, combining age estimation, gender prediction, et likely nationalities en a single response. Uses statistical models trained on millions of records de government databases dans le monde entier. Renvoie predicted age, gender probability, et top nationality matches. Idéal pour les marketing personalization, user onboarding flows, demographic research, et name-based analytics tools.

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
}