Namsor

Documentation d'API

Namsor a développé une technologie de vérification des noms, capable de créer une analyse complète grâce à un traitement multiple. Notre API peut classer les noms par origine, par ethnicité, par diaspora, par pays de résidence, par sexe, et prend en charge de nombreuses écritures*.

Introduction

À propos

Requêtes et réponses d'API

  • Tous les points de terminaison renvoient un JSON contenant soit un objet, soit un tableau d'objets imbriqué.
  • Actuellement, certains points de terminaison de l'API NamSor utilisent des structures d'objets imbriquées dans leur corps de requête et/ou leurs réponses, veuillez vous référer à l'exemple de code correspondant.
  • Sachez que les données dans les exemples de code ont été encodées en URL dans les caractères de code ASCII correspondants si nécessaire, par exemple 谢晓亮 est remplacé par %E8%B0%A2%E6%99%93% E4%BA%AE. Les URL ne peuvent pas contenir d'espaces ni de caractères non ASCII. Lorsque vous envoyez des requêtes GET à l'API, utilisez le codage d'URL pour convertir les caractères non ASCII dans un format pouvant être transmis sur Internet.

Confidentialité des données

Par défaut, l'algorithme d'apprentissage automatique de Namsor peut améliorer l'évaluation des données en fonction des entrées de données et stocke les journaux des demandes soumises. Vous pouvez modifier ces paramètres soit dans votre compte utilisateur, soit en appelant les points de terminaison API dédiés. Tous les journaux de données sont sécurisés à l'aide du cryptage AES avant d'être stockés.

Si vous souhaitez désactiver l'apprentissage automatique en fonction de vos soumissions, veuillez définir learnable sur false dans la section "Protection de la vie privée" à la page Mon compte. Lorsqu'il est défini sur false pour une clé API, les données traitées à l'aide de cette clé n'alimenteront pas l'algorithme d'apprentissage automatique.

Si vous souhaitez désactiver l'historique d'utilisation du service, veuillez définir anonymized sur true dans la section "Protection de la vie privée" à la page Mon compte. Lorsqu'il est défini sur true pour une clé API, les données traitées à l'aide de cette clé seront anonymisées de manière irréversible à l'aide du cryptage SHA. Notez que le traitement intelligent des requêtes redondantes fonctionnera toujours même si vos données sont anonymisées.

Authentication

Création de clé d'API

Les comptes clients sont communs à tous les sites du groupe Namsor. Pour créer une clé API, visitez Namsor ou un autre site du groupe Namsor et créer un compte. Accédez à la page d'informations sur le compte pour récupérer votre clé API. Votre compte nouvellement créé est livré avec 500 crédits gratuits que vous pouvez utiliser immédiatement avec l'un des outils de Namsor : API, processeur de fichiers CSV et Excel ou outils de développement.

Installation clé d'API

Votre clé API doit être définie dans l'en-tête de votre requête à l'aide de la propriété X-API-KEY. Veuillez vous référer aux exemples de code fournis pour une installation correcte de la clé.

information

Vous devez remplacer your-api-key par votre clé API Namsor.

Crédits

Que sont les crédits

Nous utilisons un système de crédit pour suivre l'utilisation de nos services. Chaque plan est livré avec une quantité mensuelle de crédits données et un prix correspondant. Le plan d'abonnement gratuit de base vous accorde 500 crédits mais d'autres plans sont disponibles au cas où vous auriez des exigences plus élevées. À titre d'exemple, avec 500 crédits vous pouvez soit :

  • Traiter 50 noms pour déterminer leurs origines.
  • Traiter 25 noms pour déterminer leurs diasporas.
  • Transliterer 500 noms Japonais.
  • Traitez 50 noms pour déterminer leur pays de résidence.
  • Traitez 500 noms pour déterminer leur sexe.
information

Les routes d'administration sont gratuites.

Tolérance des opérations répétées

Notre API propose un traitement intelligent et ne facturera pas l'analyse de données identiques (jusqu'à 20 fois). Par exemple, si vous soumettez le même nom complet 5 fois afin de déduire son origine, vous ne serez facturé que 1 crédit.

Limite flexible vs limite stricte

Dans votre compte utilisateur, vous pouvez définir deux types de limites d'utilisation du crédit :

  • Une limite souple qui déclenchera une notification par e-mail lorsqu'elle sera atteinte.
  • Une limite stricte qui déclenchera une notification par e-mail et bloquera la clé API lorsqu'elle sera atteinte.

Suivre l'utilisation

Il existe deux façons de suivre l'utilisation de votre crédit : vérifiez les graphiques fournis dans votre compte utilisateur ou interrogez les itinéraires d'administration appropriés (utilisation de l'API, historique de l'utilisation de l'API et agrégat de l'historique de l'utilisation de l'API).

Erreurs

  • 401Non autoriséClé API manquante ou incorrecte.
  • 403InterditLimite API atteinte ou clé API désactivée.
  • 404IntrouvableL'itinéraire spécifié est introuvable.
  • 500Erreur de serveur interneErreur de serveur. Réessayez plus tard.

Origine des noms

Namsor vous aide à trouver des informations détaillées sur l'origine d'un nom en établissant le pays d'origine d'un nom, l'ethnie, la diaspora et le pays de residence. Nous fournissons également une API d'évaluation des corridors, pour vérifier les informations générales sur les interactions internationales.

Origine

La fonctionnalité Origine analyse un prénom et/ou un nom de famille pour identifier le pays d'origine. L'ajout d'un prénom et d'un nom augmente la précision de l'estimation.
La fonctionnalité renvoie la région d'origine, le pays d'origine et une liste des 10 pays d'origine les plus probables. Chaque pays d'origine estimé est accompagné d'une probabilité calibrée.

Notez que le fonctionnalité Diaspora peut être mieux adaptée aux pays multiculturels, tels que les États-Unis, le Canada, l'Australie, la Nouvelle-Zélande et d'autres "melting-pots".

  • Description : Renvoie le pays d'origine le plus probable d'un maximum de 100 prénoms et/ou noms de famille.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/originBatch

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisA list of personal names.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés avec leurs pays d'origine.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].countryOriginStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].countryOriginAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
[{...}].countriesOriginTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].regionOriginStringRégion d'origine la plus probable.Régions
[{...}].topRegionOriginStringRégion d'origine la plus probable (classification alternative).Régions
[{...}].subRegionOriginStringSous-région d'origine la plus probable.Sous régions
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].religionStatsArray of objectsStatistiques religieuses pour le pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine le plus probable (countryOrigin).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour le second pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays d'origine le plus probable (countryOriginAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays d'origine le plus probable (countryOriginAlt).

Exemples d'intégration:

Name Origin exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/originBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Keith","lastName":"Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
            "score": 3.736975858512923,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.48126571888420216,
            "probabilityAltCalibrated": 0.622489299549084,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 85.24262131
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 14.20710355
                },
                {
                    "religion": "Other",
                    "pct": 0.300150075
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.050025013
                },
                {
                    "religion": "Folk",
                    "pct": 0.050025013
                },
                {
                    "religion": "Hindu",
                    "pct": 0.050025013
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050025013
                },
                {
                    "religion": "Muslim",
                    "pct": 0.050025013
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 88.97427291753932
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 9.78531187532157
                },
                {
                    "religion": "Muslim",
                    "pct": 0.6298564872835054
                },
                {
                    "religion": "Other",
                    "pct": 0.16200879680269425
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Folk",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Hindu",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050011199980789234
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/originBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Keith\",\"lastName\":\"Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
            "score": 3.736975858512923,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.48126571888420216,
            "probabilityAltCalibrated": 0.622489299549084,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 85.24262131
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 14.20710355
                },
                {
                    "religion": "Other",
                    "pct": 0.300150075
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.050025013
                },
                {
                    "religion": "Folk",
                    "pct": 0.050025013
                },
                {
                    "religion": "Hindu",
                    "pct": 0.050025013
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050025013
                },
                {
                    "religion": "Muslim",
                    "pct": 0.050025013
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 88.97427291753932
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 9.78531187532157
                },
                {
                    "religion": "Muslim",
                    "pct": 0.6298564872835054
                },
                {
                    "religion": "Other",
                    "pct": 0.16200879680269425
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Folk",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Hindu",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050011199980789234
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/originBatch"

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
            "score": 3.736975858512923,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.48126571888420216,
            "probabilityAltCalibrated": 0.622489299549084,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 85.24262131
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 14.20710355
                },
                {
                    "religion": "Other",
                    "pct": 0.300150075
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.050025013
                },
                {
                    "religion": "Folk",
                    "pct": 0.050025013
                },
                {
                    "religion": "Hindu",
                    "pct": 0.050025013
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050025013
                },
                {
                    "religion": "Muslim",
                    "pct": 0.050025013
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 88.97427291753932
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 9.78531187532157
                },
                {
                    "religion": "Muslim",
                    "pct": 0.6298564872835054
                },
                {
                    "religion": "Other",
                    "pct": 0.16200879680269425
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Folk",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Hindu",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050011199980789234
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/originBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstName": "Keith",
            "lastName": "Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
            "score": 3.736975858512923,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.48126571888420216,
            "probabilityAltCalibrated": 0.622489299549084,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 85.24262131
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 14.20710355
                },
                {
                    "religion": "Other",
                    "pct": 0.300150075
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.050025013
                },
                {
                    "religion": "Folk",
                    "pct": 0.050025013
                },
                {
                    "religion": "Hindu",
                    "pct": 0.050025013
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050025013
                },
                {
                    "religion": "Muslim",
                    "pct": 0.050025013
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 88.97427291753932
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 9.78531187532157
                },
                {
                    "religion": "Muslim",
                    "pct": 0.6298564872835054
                },
                {
                    "religion": "Other",
                    "pct": 0.16200879680269425
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Folk",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Hindu",
                    "pct": 0.13284624102403442
                },
                {
                    "religion": "Jewish",
                    "pct": 0.050011199980789234
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Renvoie le pays d'origine le plus probable à partir d'un prénom et/ou d'un nom de famille.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/origin/{firstName}/{lastName}

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
countryOriginStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
countryOriginAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
countriesOriginTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
regionOriginStringRégion d'origine la plus probable.Régions
topRegionOriginStringRégion d'origine la plus probable (classification alternative).Régions
subRegionOriginStringSous-région d'origine d'origine la plus probable.Sous régions
probabilityCalibratedNumberLa probabilité calibrée que 'countryOrigin' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'countryOrigin' ou 'countryOriginAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
religionStatsArray of objectsStatistiques religieuses pour le pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine le plus probable (countryOrigin).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine le plus probable (countryOrigin).
religionStatsAltArray of objectsStatistiques religieuses pour le second pays d'origine le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays d'origine le plus probable (countryOriginAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays d'origine le plus probable (countryOriginAlt).

Exemples d'intégration:

Name Origin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
    "score": 3.736975858512923,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.48126571888420216,
    "probabilityAltCalibrated": 0.622489299549084,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 85.24262131
        },
        {
            "religion": "Unaffiliated",
            "pct": 14.20710355
        },
        {
            "religion": "Other",
            "pct": 0.300150075
        },
        {
            "religion": "Buddhist",
            "pct": 0.050025013
        },
        {
            "religion": "Folk",
            "pct": 0.050025013
        },
        {
            "religion": "Hindu",
            "pct": 0.050025013
        },
        {
            "religion": "Jewish",
            "pct": 0.050025013
        },
        {
            "religion": "Muslim",
            "pct": 0.050025013
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 88.97427291753932
        },
        {
            "religion": "Unaffiliated",
            "pct": 9.78531187532157
        },
        {
            "religion": "Muslim",
            "pct": 0.6298564872835054
        },
        {
            "religion": "Other",
            "pct": 0.16200879680269425
        },
        {
            "religion": "Buddhist",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Folk",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Hindu",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Jewish",
            "pct": 0.050011199980789234
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
    "score": 3.736975858512923,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.48126571888420216,
    "probabilityAltCalibrated": 0.622489299549084,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 85.24262131
        },
        {
            "religion": "Unaffiliated",
            "pct": 14.20710355
        },
        {
            "religion": "Other",
            "pct": 0.300150075
        },
        {
            "religion": "Buddhist",
            "pct": 0.050025013
        },
        {
            "religion": "Folk",
            "pct": 0.050025013
        },
        {
            "religion": "Hindu",
            "pct": 0.050025013
        },
        {
            "religion": "Jewish",
            "pct": 0.050025013
        },
        {
            "religion": "Muslim",
            "pct": 0.050025013
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 88.97427291753932
        },
        {
            "religion": "Unaffiliated",
            "pct": 9.78531187532157
        },
        {
            "religion": "Muslim",
            "pct": 0.6298564872835054
        },
        {
            "religion": "Other",
            "pct": 0.16200879680269425
        },
        {
            "religion": "Buddhist",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Folk",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Hindu",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Jewish",
            "pct": 0.050011199980789234
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
    "score": 3.736975858512923,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.48126571888420216,
    "probabilityAltCalibrated": 0.622489299549084,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 85.24262131
        },
        {
            "religion": "Unaffiliated",
            "pct": 14.20710355
        },
        {
            "religion": "Other",
            "pct": 0.300150075
        },
        {
            "religion": "Buddhist",
            "pct": 0.050025013
        },
        {
            "religion": "Folk",
            "pct": 0.050025013
        },
        {
            "religion": "Hindu",
            "pct": 0.050025013
        },
        {
            "religion": "Jewish",
            "pct": 0.050025013
        },
        {
            "religion": "Muslim",
            "pct": 0.050025013
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 88.97427291753932
        },
        {
            "religion": "Unaffiliated",
            "pct": 9.78531187532157
        },
        {
            "religion": "Muslim",
            "pct": 0.6298564872835054
        },
        {
            "religion": "Other",
            "pct": 0.16200879680269425
        },
        {
            "religion": "Buddhist",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Folk",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Hindu",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Jewish",
            "pct": 0.050011199980789234
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/origin/Keith/Haring", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "MY", "SE", "CH", "NO", "EE"],
    "score": 3.736975858512923,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.48126571888420216,
    "probabilityAltCalibrated": 0.622489299549084,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 85.24262131
        },
        {
            "religion": "Unaffiliated",
            "pct": 14.20710355
        },
        {
            "religion": "Other",
            "pct": 0.300150075
        },
        {
            "religion": "Buddhist",
            "pct": 0.050025013
        },
        {
            "religion": "Folk",
            "pct": 0.050025013
        },
        {
            "religion": "Hindu",
            "pct": 0.050025013
        },
        {
            "religion": "Jewish",
            "pct": 0.050025013
        },
        {
            "religion": "Muslim",
            "pct": 0.050025013
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 88.97427291753932
        },
        {
            "religion": "Unaffiliated",
            "pct": 9.78531187532157
        },
        {
            "religion": "Muslim",
            "pct": 0.6298564872835054
        },
        {
            "religion": "Other",
            "pct": 0.16200879680269425
        },
        {
            "religion": "Buddhist",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Folk",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Hindu",
            "pct": 0.13284624102403442
        },
        {
            "religion": "Jewish",
            "pct": 0.050011199980789234
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 85.24262131 },
    { religion: 'Unaffiliated', pct: 14.20710355 },
    { religion: 'Other', pct: 0.300150075 },
    { religion: 'Buddhist', pct: 0.050025013 },
    { religion: 'Folk', pct: 0.050025013 },
    { religion: 'Hindu', pct: 0.050025013 },
    { religion: 'Jewish', pct: 0.050025013 },
    { religion: 'Muslim', pct: 0.050025013 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 88.97427291753932 },
    { religion: 'Unaffiliated', pct: 9.78531187532157 },
    { religion: 'Muslim', pct: 0.6298564872835054 },
    { religion: 'Other', pct: 0.16200879680269425 },
    { religion: 'Buddhist', pct: 0.13284624102403442 },
    { religion: 'Folk', pct: 0.13284624102403442 },
    { religion: 'Hindu', pct: 0.13284624102403442 },
    { religion: 'Jewish', pct: 0.050011199980789234 },
  ],
}

Diaspora

La fonctionnalité Diaspora analyse un nom pour identifier l'ethnie/diaspora la plus probable. L'ajout d'un prénom, d'un nom de famille et d'un pays de résidence augmente la précision de la diaspora estimée.
La fonctionnalité renvoie l'ethnie/diaspora la plus probable et un top 10 des ethnies classées du plus probable au moins probable. Chaque ethnie renvoyée est accompagnée d'une probabilité calibrée.

  • Description : Estime les ethnicités/diasporas les plus vraisemblable d'un ensemble de prénoms, d'un noms de famille et de pays de résidence.
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringRequisNom de famille.
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis avec leurs ethnies estimées.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].ethnicityAltStringSeconde ethnie la plus probable.Ethnicités et diasporas
[{...}].ethnicityStringEthnie la plus probable.Ethnicités et diasporas
[{...}].liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
[{...}].countryIso2StringSubmitted Pays de résidence, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].ethnicitiesTopArrayTop 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].religionStatsArray of objectsStatistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion au sein de la diaspora la plus probable (ethnicity).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour la seconde diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion au sein de la seconde diaspora la plus probable (ethnicityAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion au sein de la seconde diaspora la plus probable (ethnicityAlt).

Exemples d'intégration:

Name Diaspora exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"0d7d6417-0bbb-4205-951d-b3473f605b56","firstName":"Keith","lastName":"Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 10.578504679244919,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
            "probabilityCalibrated": 0.6115763692637636,
            "probabilityAltCalibrated": 0.6115763692637636,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"0d7d6417-0bbb-4205-951d-b3473f605b56\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 10.578504679244919,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
            "probabilityCalibrated": 0.6115763692637636,
            "probabilityAltCalibrated": 0.6115763692637636,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch"

payload = {
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 10.578504679244919,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
            "probabilityCalibrated": 0.6115763692637636,
            "probabilityAltCalibrated": 0.6115763692637636,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 10.578504679244919,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
            "probabilityCalibrated": 0.6115763692637636,
            "probabilityAltCalibrated": 0.6115763692637636,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 68.7
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 24.7
                },
                {
                    "religion": "Muslim",
                    "pct": 5.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 0.3
                },
                {
                    "religion": "Jewish",
                    "pct": 0.3
                },
                {
                    "religion": "Other",
                    "pct": 0.1
                },
                {
                    "religion": "Folk",
                    "pct": 0.05
                },
                {
                    "religion": "Hindu",
                    "pct": 0.05
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Détermine l'ethnicité/diaspora la plus vraisemblable à partir d'un prénom, d'un nom de famille et d'un pays de résidence.
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/{countryIso2}/{firstName}/{lastName}

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
ethnicityAltStringSeconde ethnie la plus probable.Ethnicités et diasporas
ethnicityStringEthnie la plus probable.Ethnicités et diasporas
liftedBooleanIndique si le résultat du champ "ethnicity" est basé uniquement sur l'apprentissage automatique ou s'il est davantage considéré comme un fait connu par une règle spécifique au pays.
countryIso2StringPays de résidence, au format ISO 3166-1 alpha-2.Pays de résidence
ethnicitiesTopArrayTop 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
probabilityCalibratedNumberLa probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.
religionStatsArray of objectsStatistiques religieuses pour le pays d'origine de la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine de la diaspora la plus probable (ethnicity).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine de la diaspora la plus probable (ethnicity).
religionStatsAltArray of objectsStatistiques religieuses pour le pays d'origine de la seconde diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays d'origine de la seconde diaspora la plus probable (ethnicityAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays d'origine de la seconde diaspora la plus probable (ethnicityAlt).

Exemples d'intégration:

Name Diaspora exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 10.578504679244919,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
    "probabilityCalibrated": 0.6115763692637636,
    "probabilityAltCalibrated": 0.6115763692637636,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 10.578504679244919,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
    "probabilityCalibrated": 0.6115763692637636,
    "probabilityAltCalibrated": 0.6115763692637636,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 10.578504679244919,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
    "probabilityCalibrated": 0.6115763692637636,
    "probabilityAltCalibrated": 0.6115763692637636,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diaspora/US/Keith/Haring", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 10.578504679244919,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Jewish", "Norwegian", "HispanoLatino", "Swedish", "AfricanAmerican"],
    "probabilityCalibrated": 0.6115763692637636,
    "probabilityAltCalibrated": 0.6115763692637636,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 68.7
        },
        {
            "religion": "Unaffiliated",
            "pct": 24.7
        },
        {
            "religion": "Muslim",
            "pct": 5.8
        },
        {
            "religion": "Buddhist",
            "pct": 0.3
        },
        {
            "religion": "Jewish",
            "pct": 0.3
        },
        {
            "religion": "Other",
            "pct": 0.1
        },
        {
            "religion": "Folk",
            "pct": 0.05
        },
        {
            "religion": "Hindu",
            "pct": 0.05
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 68.7 },
    { religion: 'Unaffiliated', pct: 24.7 },
    { religion: 'Muslim', pct: 5.8 },
    { religion: 'Buddhist', pct: 0.3 },
    { religion: 'Jewish', pct: 0.3 },
    { religion: 'Other', pct: 0.1 },
    { religion: 'Folk', pct: 0.05 },
    { religion: 'Hindu', pct: 0.05 },
  ],
}

Ethnie US

La fonctionnalité Ethnie US analyse un nom pour identifier l'ethnie 'raciale' US la plus probable. L'ajout d'un prénom, d'un nom de famille et d'un pays de résidence augmente la précision de l'ethnie 'raciale' américaine déterminée.
La fonction renvoie l'ethnie 'raciale' US la plus probable et une liste des ethnies 'raciales' US triées du plus probable au moins probable. Chaque ethnie 'raciale' estimée est accompagnée d'une probabilité calibrée.

L'ethnie 'raciale' US est une catégorisation officielle du bureau du recensement des États-Unis

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés enrichis de leur ethnie 'raciale'.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"85dd5f48-b9e1-4019-88ce-ccc7e56b763f","firstName":"Keith","lastName":"Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 7.104050454229515,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
            "probabilityCalibrated": 0.7271969971540807,
            "probabilityAltCalibrated": 0.8701551006716921
        }
    ]
}

Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"85dd5f48-b9e1-4019-88ce-ccc7e56b763f\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 7.104050454229515,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
            "probabilityCalibrated": 0.7271969971540807,
            "probabilityAltCalibrated": 0.8701551006716921
        }
    ]
}

Name US Race exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch"

payload = {
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 7.104050454229515,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
            "probabilityCalibrated": 0.7271969971540807,
            "probabilityAltCalibrated": 0.8701551006716921
        }
    ]
}

Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 7.104050454229515,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
            "probabilityCalibrated": 0.7271969971540807,
            "probabilityAltCalibrated": 0.8701551006716921
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/{firstName}/{lastName}

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 7.104050454229515,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
    "probabilityCalibrated": 0.7271969971540807,
    "probabilityAltCalibrated": 0.8701551006716921
}

Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 7.104050454229515,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
    "probabilityCalibrated": 0.7271969971540807,
    "probabilityAltCalibrated": 0.8701551006716921
}

Name US Race exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 7.104050454229515,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
    "probabilityCalibrated": 0.7271969971540807,
    "probabilityAltCalibrated": 0.8701551006716921
}

Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicity/Keith/Haring", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 7.104050454229515,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "B_NL", "A", "PI", "HL"],
    "probabilityCalibrated": 0.7271969971540807,
    "probabilityAltCalibrated": 0.8701551006716921
}

Ethnie US (ZIP)

La fonctionnalité Ethnie US (ZIP) analyse un nom pour identifier l'ethnie 'raciale' US la plus probable avec une précision améliorée par rapport à la fonctionnalité de base Ethnie US. L'ajout d'un prénom, d'un nom de famille et d'un pays de résidence augmente la précision de l'ethnie 'raciale' américaine déterminée.
La fonction renvoie l'ethnie 'raciale' US la plus probable et une liste des ethnies 'raciales' US triées du plus probable au moins probable. Chaque ethnie 'raciale' estimée est accompagnée d'une probabilité calibrée.

L'ethnie 'raciale' US est une catégorisation officielle du bureau du recensement des États-Unis

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms de personnes avec leur pays de résidence et leur code postal.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2.
[{...}].zipCodeStringRequisCode postal (5 chiffres) de résidence utilisé par le service postal des États-Unis (USPS).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés enrichis de leur ethnie 'raciale'.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race ZIP exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"728767f9-c5b2-4ed3-a071-828077f16552","firstName":"Keith","lastName":"Haring","countryIso2":"US","zipCode":"10019"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 3.9085123822664136,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
            "probabilityCalibrated": 0.6021205204922562,
            "probabilityAltCalibrated": 0.8421508050514268
        }
    ]
}

Name US Race ZIP exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"728767f9-c5b2-4ed3-a071-828077f16552\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\",\"zipCode\":\"10019\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 3.9085123822664136,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
            "probabilityCalibrated": 0.6021205204922562,
            "probabilityAltCalibrated": 0.8421508050514268
        }
    ]
}

Name US Race ZIP exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch"

payload = {
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 3.9085123822664136,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
            "probabilityCalibrated": 0.6021205204922562,
            "probabilityAltCalibrated": 0.8421508050514268
        }
    ]
}

Name US Race ZIP exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usZipRaceEthnicityBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "728767f9-c5b2-4ed3-a071-828077f16552",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US",
      "zipCode": "10019"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "728767f9-c5b2-4ed3-a071-828077f16552",
            "firstName": "Keith",
            "lastName": "Haring",
            "raceEthnicityAlt": "AI_AN",
            "raceEthnicity": "W_NL",
            "score": 3.9085123822664136,
            "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
            "probabilityCalibrated": 0.6021205204922562,
            "probabilityAltCalibrated": 0.8421508050514268
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/{firstName}/{lastName}/{zipCode}

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-USRACEETHNICITY-TAXONOMYUSRACEETHNICITY-6CLASSESOptionelRecenseurs pour l'ethnie 'raciale' estimée. Ne précisez pas la propriété de la requête http pour obtenir 4 classes (W_NL, HL, A, B_NL), USRACEETHNICITY-6CLASSES renverra 6 classes (W_NL, HL, A, B_NL, AI_AN, PI). Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
zipCodeStringRequisCode postal (5 chiffres) de résidence utilisé par le service postal des États-Unis (USPS).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
raceEthnicityAltStringSeconde ethnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
raceEthnicityStringEthnie 'raciale' la plus probable (catégorisation 'raciale' US de l'US Census).Ethnies raciales US
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
raceEthnicitiesTopArrayEthnies 'raciales' triées des plus probables au moins probables.Ethnies raciales US
probabilityCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ait été devinée correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'raceEthnicity' ou 'raceEthnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage.

Exemples d'intégration:

Name US Race ZIP exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019 \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 3.9085123822664136,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
    "probabilityCalibrated": 0.6021205204922562,
    "probabilityAltCalibrated": 0.8421508050514268
}

Name US Race ZIP exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 3.9085123822664136,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
    "probabilityCalibrated": 0.6021205204922562,
    "probabilityAltCalibrated": 0.8421508050514268
}

Name US Race ZIP exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 3.9085123822664136,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
    "probabilityCalibrated": 0.6021205204922562,
    "probabilityAltCalibrated": 0.8421508050514268
}

Name US Race ZIP exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityZIP5/Keith/Haring/10019", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "728767f9-c5b2-4ed3-a071-828077f16552",
    "firstName": "Keith",
    "lastName": "Haring",
    "raceEthnicityAlt": "AI_AN",
    "raceEthnicity": "W_NL",
    "score": 3.9085123822664136,
    "raceEthnicitiesTop": ["W_NL", "AI_AN", "A", "B_NL", "PI", "HL"],
    "probabilityCalibrated": 0.6021205204922562,
    "probabilityAltCalibrated": 0.8421508050514268
}

Pays de Residence

La fonctionnalité Pays de Residence analyse un nom (prénom, nom de famille ou nom complet) pour identifier son pays de résidence.
La fonctionnalité renvoie la région de résidence, le pays de résidence et une liste des 10 principaux pays de résidence, classés du plus probable au moins probable. Chaque pays de résidence renvoyé est accompagné d'une probabilité calibrée.

  • Description : Renvoie le pays de résidence le plus probable parmi 100 prénoms, noms ou noms complets.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Pays de Residence.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisA list of personal names.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisPrénom, ou nom de famille, ou nom complet.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms renseignés avec leurs pays de résidence.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom renseigné.
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].countryStringPays de résidence le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].countryAltStringSecond pays de résidence le plsu vraisemblable, au format ISO 3166-1 alpha-2.Pays de résidence
[{...}].regionStringRégion de résidence la plus probable.Régions
[{...}].topRegionStringRégion de résidence la plus probable (classification alternative).Régions
[{...}].subRegionStringSous-région de résidence la plus probable.Sous régions
[{...}].countriesTopArrayTop 10 des pays de résidence les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.
[{...}].probabilityCalibratedNumberLa probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].probabilityAltCalibratedNumberLa probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
[{...}].religionStatsArray of objectsStatistiques religieuses pour le pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays de résidence le plus probable (country).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country).
[{...}].religionStatsAltArray of objectsStatistiques religieuses pour le second pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays de résidence le plus probable (countryAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays de résidence le plus probable (countryAlt).

Exemples d'intégration:

Name Country exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4","name":"Keith Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 14.474855749439138,
            "country": "US",
            "countryAlt": "NZ",
            "region": "Northern America",
            "topRegion": "Americas",
            "subRegion": "Northern America",
            "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
            "probabilityCalibrated": 0.5543051242619337,
            "probabilityAltCalibrated": 0.5722556327291567,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 78.3
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.4
                },
                {
                    "religion": "Jewish",
                    "pct": 1.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.2
                },
                {
                    "religion": "Muslim",
                    "pct": 0.9
                },
                {
                    "religion": "Hindu",
                    "pct": 0.6
                },
                {
                    "religion": "Other",
                    "pct": 0.6
                },
                {
                    "religion": "Folk",
                    "pct": 0.2
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 78.3007843079025
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.39975226849653
                },
                {
                    "religion": "Jewish",
                    "pct": 1.799802305332493
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.1998700873301702
                },
                {
                    "religion": "Muslim",
                    "pct": 0.8999039783290091
                },
                {
                    "religion": "Other",
                    "pct": 0.5999661259551334
                },
                {
                    "religion": "Hindu",
                    "pct": 0.5999378693278477
                },
                {
                    "religion": "Folk",
                    "pct": 0.1999830573262992
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Name Country exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4\",\"name\":\"Keith Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 14.474855749439138,
            "country": "US",
            "countryAlt": "NZ",
            "region": "Northern America",
            "topRegion": "Americas",
            "subRegion": "Northern America",
            "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
            "probabilityCalibrated": 0.5543051242619337,
            "probabilityAltCalibrated": 0.5722556327291567,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 78.3
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.4
                },
                {
                    "religion": "Jewish",
                    "pct": 1.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.2
                },
                {
                    "religion": "Muslim",
                    "pct": 0.9
                },
                {
                    "religion": "Hindu",
                    "pct": 0.6
                },
                {
                    "religion": "Other",
                    "pct": 0.6
                },
                {
                    "religion": "Folk",
                    "pct": 0.2
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 78.3007843079025
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.39975226849653
                },
                {
                    "religion": "Jewish",
                    "pct": 1.799802305332493
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.1998700873301702
                },
                {
                    "religion": "Muslim",
                    "pct": 0.8999039783290091
                },
                {
                    "religion": "Other",
                    "pct": 0.5999661259551334
                },
                {
                    "religion": "Hindu",
                    "pct": 0.5999378693278477
                },
                {
                    "religion": "Folk",
                    "pct": 0.1999830573262992
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Name Country exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch"

payload = {
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 14.474855749439138,
            "country": "US",
            "countryAlt": "NZ",
            "region": "Northern America",
            "topRegion": "Americas",
            "subRegion": "Northern America",
            "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
            "probabilityCalibrated": 0.5543051242619337,
            "probabilityAltCalibrated": 0.5722556327291567,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 78.3
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.4
                },
                {
                    "religion": "Jewish",
                    "pct": 1.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.2
                },
                {
                    "religion": "Muslim",
                    "pct": 0.9
                },
                {
                    "religion": "Hindu",
                    "pct": 0.6
                },
                {
                    "religion": "Other",
                    "pct": 0.6
                },
                {
                    "religion": "Folk",
                    "pct": 0.2
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 78.3007843079025
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.39975226849653
                },
                {
                    "religion": "Jewish",
                    "pct": 1.799802305332493
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.1998700873301702
                },
                {
                    "religion": "Muslim",
                    "pct": 0.8999039783290091
                },
                {
                    "religion": "Other",
                    "pct": 0.5999661259551334
                },
                {
                    "religion": "Hindu",
                    "pct": 0.5999378693278477
                },
                {
                    "religion": "Folk",
                    "pct": 0.1999830573262992
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Name Country exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/countryBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "name": "Keith Haring",
            "score": 14.474855749439138,
            "country": "US",
            "countryAlt": "NZ",
            "region": "Northern America",
            "topRegion": "Americas",
            "subRegion": "Northern America",
            "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
            "probabilityCalibrated": 0.5543051242619337,
            "probabilityAltCalibrated": 0.5722556327291567,
            "religionStats": [
                {
                    "religion": "Christian",
                    "pct": 78.3
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.4
                },
                {
                    "religion": "Jewish",
                    "pct": 1.8
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.2
                },
                {
                    "religion": "Muslim",
                    "pct": 0.9
                },
                {
                    "religion": "Hindu",
                    "pct": 0.6
                },
                {
                    "religion": "Other",
                    "pct": 0.6
                },
                {
                    "religion": "Folk",
                    "pct": 0.2
                }
            ],
            "religionStatsAlt": [
                {
                    "religion": "Christian",
                    "pct": 78.3007843079025
                },
                {
                    "religion": "Unaffiliated",
                    "pct": 16.39975226849653
                },
                {
                    "religion": "Jewish",
                    "pct": 1.799802305332493
                },
                {
                    "religion": "Buddhist",
                    "pct": 1.1998700873301702
                },
                {
                    "religion": "Muslim",
                    "pct": 0.8999039783290091
                },
                {
                    "religion": "Other",
                    "pct": 0.5999661259551334
                },
                {
                    "religion": "Hindu",
                    "pct": 0.5999378693278477
                },
                {
                    "religion": "Folk",
                    "pct": 0.1999830573262992
                }
            ]
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Renvoie le pays de résidence le plus probable à partir d'un prénom, d'un nom de famille ou d'un nom complet.
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Pays de Residence.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/country/{name}

En-tête de requête

PropriétéValeursRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
X-OPTION-RELIGION-STATSTrueOptionelRetourne les statistiques religieuses pour les pays d'origine, les pays de residence et les diasporas estimés. Par défault la fonctionnalité est désactivée. Ajoutez au Header de la requête la paramêtre X-OPTION-RELIGION-STATS sur True pour l'activer.
Paramètres de requête
NomTypeRequisDescription
nameStringRequisPrénom, ou nom de famille, ou nom complet.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringLe nom renseigné.
scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
countryStringPays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
countryAltStringSecond pays d'origine le plus probable, au format ISO 3166-1 alpha-2.Pays de résidence
regionStringRégion d'origine la plus probable.Régions
topRegionStringRégion d'origine la plus probable (classification alternative).Régions
subRegionStringSous-région.Sous régions
countriesTopArrayTop 10 des pays d'origine les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.
probabilityCalibratedNumberLa probabilité calibrée que 'country' ait été deviné correctement. -1 = toujours en cours de calibrage.
probabilityAltCalibratedNumberLa probabilité calibrée que 'country' ou 'countryAlt' aient été deviné correctement. -1 = toujours en cours de calibrage.
religionStatsArray of objectsStatistiques religieuses pour le pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le pays de résidence le plus probable (country).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le pays de résidence le plus probable (country).
religionStatsAltArray of objectsStatistiques religieuses pour le second pays de résidence le plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True).
[{...}].religionStringReligion dans le second pays de résidence le plus probable (countryAlt).Religions
[{...}].pctNumberPourcentage de la population pratiquant cette religion dans le second pays de résidence le plus probable (countryAlt).

Exemples d'intégration:

Name Country exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 14.474855749439138,
    "country": "US",
    "countryAlt": "NZ",
    "region": "Northern America",
    "topRegion": "Americas",
    "subRegion": "Northern America",
    "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
    "probabilityCalibrated": 0.5543051242619337,
    "probabilityAltCalibrated": 0.5722556327291567,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 78.3
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.4
        },
        {
            "religion": "Jewish",
            "pct": 1.8
        },
        {
            "religion": "Buddhist",
            "pct": 1.2
        },
        {
            "religion": "Muslim",
            "pct": 0.9
        },
        {
            "religion": "Hindu",
            "pct": 0.6
        },
        {
            "religion": "Other",
            "pct": 0.6
        },
        {
            "religion": "Folk",
            "pct": 0.2
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 78.3007843079025
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.39975226849653
        },
        {
            "religion": "Jewish",
            "pct": 1.799802305332493
        },
        {
            "religion": "Buddhist",
            "pct": 1.1998700873301702
        },
        {
            "religion": "Muslim",
            "pct": 0.8999039783290091
        },
        {
            "religion": "Other",
            "pct": 0.5999661259551334
        },
        {
            "religion": "Hindu",
            "pct": 0.5999378693278477
        },
        {
            "religion": "Folk",
            "pct": 0.1999830573262992
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Name Country exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 14.474855749439138,
    "country": "US",
    "countryAlt": "NZ",
    "region": "Northern America",
    "topRegion": "Americas",
    "subRegion": "Northern America",
    "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
    "probabilityCalibrated": 0.5543051242619337,
    "probabilityAltCalibrated": 0.5722556327291567,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 78.3
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.4
        },
        {
            "religion": "Jewish",
            "pct": 1.8
        },
        {
            "religion": "Buddhist",
            "pct": 1.2
        },
        {
            "religion": "Muslim",
            "pct": 0.9
        },
        {
            "religion": "Hindu",
            "pct": 0.6
        },
        {
            "religion": "Other",
            "pct": 0.6
        },
        {
            "religion": "Folk",
            "pct": 0.2
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 78.3007843079025
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.39975226849653
        },
        {
            "religion": "Jewish",
            "pct": 1.799802305332493
        },
        {
            "religion": "Buddhist",
            "pct": 1.1998700873301702
        },
        {
            "religion": "Muslim",
            "pct": 0.8999039783290091
        },
        {
            "religion": "Other",
            "pct": 0.5999661259551334
        },
        {
            "religion": "Hindu",
            "pct": 0.5999378693278477
        },
        {
            "religion": "Folk",
            "pct": 0.1999830573262992
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Name Country exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 14.474855749439138,
    "country": "US",
    "countryAlt": "NZ",
    "region": "Northern America",
    "topRegion": "Americas",
    "subRegion": "Northern America",
    "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
    "probabilityCalibrated": 0.5543051242619337,
    "probabilityAltCalibrated": 0.5722556327291567,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 78.3
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.4
        },
        {
            "religion": "Jewish",
            "pct": 1.8
        },
        {
            "religion": "Buddhist",
            "pct": 1.2
        },
        {
            "religion": "Muslim",
            "pct": 0.9
        },
        {
            "religion": "Hindu",
            "pct": 0.6
        },
        {
            "religion": "Other",
            "pct": 0.6
        },
        {
            "religion": "Folk",
            "pct": 0.2
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 78.3007843079025
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.39975226849653
        },
        {
            "religion": "Jewish",
            "pct": 1.799802305332493
        },
        {
            "religion": "Buddhist",
            "pct": 1.1998700873301702
        },
        {
            "religion": "Muslim",
            "pct": 0.8999039783290091
        },
        {
            "religion": "Other",
            "pct": 0.5999661259551334
        },
        {
            "religion": "Hindu",
            "pct": 0.5999378693278477
        },
        {
            "religion": "Folk",
            "pct": 0.1999830573262992
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Name Country exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/country/Keith%20Haring", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "name": "Keith Haring",
    "score": 14.474855749439138,
    "country": "US",
    "countryAlt": "NZ",
    "region": "Northern America",
    "topRegion": "Americas",
    "subRegion": "Northern America",
    "countriesTop": ["US", "NZ", "AU", "GB", "IE", "CA", "DE", "SG", "JM", "HK"],
    "probabilityCalibrated": 0.5543051242619337,
    "probabilityAltCalibrated": 0.5722556327291567,
    "religionStats": [
        {
            "religion": "Christian",
            "pct": 78.3
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.4
        },
        {
            "religion": "Jewish",
            "pct": 1.8
        },
        {
            "religion": "Buddhist",
            "pct": 1.2
        },
        {
            "religion": "Muslim",
            "pct": 0.9
        },
        {
            "religion": "Hindu",
            "pct": 0.6
        },
        {
            "religion": "Other",
            "pct": 0.6
        },
        {
            "religion": "Folk",
            "pct": 0.2
        }
    ],
    "religionStatsAlt": [
        {
            "religion": "Christian",
            "pct": 78.3007843079025
        },
        {
            "religion": "Unaffiliated",
            "pct": 16.39975226849653
        },
        {
            "religion": "Jewish",
            "pct": 1.799802305332493
        },
        {
            "religion": "Buddhist",
            "pct": 1.1998700873301702
        },
        {
            "religion": "Muslim",
            "pct": 0.8999039783290091
        },
        {
            "religion": "Other",
            "pct": 0.5999661259551334
        },
        {
            "religion": "Hindu",
            "pct": 0.5999378693278477
        },
        {
            "religion": "Folk",
            "pct": 0.1999830573262992
        }
    ]
}

Valeurs retournées uniquement si l'option de statistiques religieuses est activée X-OPTION-RELIGION-STATS : True.

{
  religionStats: [
    { religion: 'Christian', pct: 78.3 },
    { religion: 'Unaffiliated', pct: 16.4 },
    { religion: 'Jewish', pct: 1.8 },
    { religion: 'Buddhist', pct: 1.2 },
    { religion: 'Muslim', pct: 0.9 },
    { religion: 'Hindu', pct: 0.6 },
    { religion: 'Other', pct: 0.6 },
    { religion: 'Folk', pct: 0.2 },
  ],
  religionStatsAlt: [
    { religion: 'Christian', pct: 78.3007843079025 },
    { religion: 'Unaffiliated', pct: 16.39975226849653 },
    { religion: 'Jewish', pct: 1.799802305332493 },
    { religion: 'Buddhist', pct: 1.1998700873301702 },
    { religion: 'Muslim', pct: 0.8999039783290091 },
    { religion: 'Other', pct: 0.5999661259551334 },
    { religion: 'Hindu', pct: 0.5999378693278477 },
    { religion: 'Folk', pct: 0.1999830573262992 },
  ],
}

Corridor

La fonctionnalité Corridor analyse le prénom, le nom et le pays de résidence de deux personnes pour générer un rapport complet de l'interaction.

  • Description : Renvoie une analyse complète d'un ensemble d'interactions transfrontalières (jusqu'à 100) entre deux noms en utilisant leur contexte géographique. L'expéditeur est celui qui a initié l'interaction (from), tandis que le destinataire est celui destiné à recevoir l'interaction (to).
  • Coût : 20 crédits par nom.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
corridorFromToArray of objectsRequisA list of name pairs, with country code (nameFrom -> nameTo)..
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstLastNameGeoFromObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequisPrénom de l'expéditeur.
{...}.lastNameStringRequisNom de famille de l'expéditeur.
{...}.countryIso2StringRequisPays d'origine de l'expéditeur, au format ISO 3166-1 alpha-2.
[{...}].firstLastNameGeoToObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequisPrénom du destinataire.
{...}.lastNameStringRequisNom de famille du destinataire.
{...}.countryIso2StringRequisPays d'origine du destinataire, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
corridorFromToArray of objectsA list of classified name pairs..
[{...}].idStringIdentifiant unique.
[{...}].firstLastNameGeoFromGenderObjectDonnées de genre pour l'expéditeur..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.likelyGenderStringGenre le plus probable de l'expéditeur.Genres
{...}.genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].firstLastNameGeoToGenderObjectDonnées de genre pour le destinataire..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.likelyGenderStringGenre le plus probable du destinataire.Genres
{...}.genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
[{...}].firstLastNameGeoFromOriginObjectDonnées d'origine pour l'expéditeur..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.countryOriginStringPays d'origine de l'expéditeur le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countryOriginAltStringSecond pays d'origine de l'expéditeur le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countriesOriginTopArrayTop 10 des pays d'origine de l'expéditeur les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.regionOriginStringRégion d'origine de l'expéditeur la plus probable.Régions
{...}.topRegionOriginStringRégion d'origine de l'expéditeur la plus probable (classification alternative).Régions
{...}.subRegionOriginStringSous-région d'origine de l'expéditeur la plus probable.Sous régions
{...}.probabilityCalibratedNumberLa probabilité calibrée pour 'countryOrigin' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
{...}.probabilityAltCalibratedNumberLa probabilité calibrée pour 'countryOrigin' ou 'countryOriginAlt' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].firstLastNameGeoToOriginObjectDonnées d'origine pour le destinataire..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.countryOriginStringPays d'origine du destinataire le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countryOriginAltStringSecond pays d'origine du destinataire le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countriesOriginTopArrayTop 10 des pays d'origine du destinataire les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.regionOriginStringRégion d'origine du destinataire la plus probable.Régions
{...}.topRegionOriginStringRégion d'origine du destinataire la plus probable (classification alternative).Régions
{...}.subRegionOriginStringSous-région d'origine du destinataire la plus probable.Sous régions
{...}.probabilityCalibratedNumberLa probabilité calibrée pour 'countryOrigin' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
{...}.probabilityAltCalibratedNumberLa probabilité calibrée pour 'countryOrigin' ou 'countryOriginAlt' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
[{...}].firstLastNameGeoFromDiasporaObjectDonnées de la diaspora pour l'expéditeur..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.ethnicityAltStringSeconde ethnie de l'expéditeur la plus probable.Ethnicités et diasporas
{...}.ethnicityStringEthnie de l'expéditeur la plus probable.Ethnicités et diasporas
{...}.liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
{...}.countryIso2StringPays d'origine de l'expéditeur renseigné, au format ISO 3166-1 alpha-2.Pays de résidence
{...}.ethnicitiesTopArrayTop 10 des ethnies de l'expéditeur les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
[{...}].firstLastNameGeoToDiasporaObjectDonnées de la diaspora pour le destinataire..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.ethnicityAltStringSeconde ethnie du destinataire la plus probable.Ethnicités et diasporas
{...}.ethnicityStringEthnie du destinataire la plus probable.Ethnicités et diasporas
{...}.liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
{...}.countryIso2StringPays d'origine du destinataire renseigné, au format ISO 3166-1 alpha-2.Pays de résidence
{...}.ethnicitiesTopArrayTop 10 des ethnies du destinataire les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas

Exemples d'intégration:

Names Corridor exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"corridorFromTo":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstLastNameGeoFrom":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Ada","lastName":"Lovelace","countryIso2":"GB"},"firstLastNameGeoTo":{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","firstName":"Nicolas","lastName":"Tesla","countryIso2":"US"}}]}'

Paramètre du corps :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}

Names Corridor exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"corridorFromTo\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstLastNameGeoFrom\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Ada\",\"lastName\":\"Lovelace\",\"countryIso2\":\"GB\"},\"firstLastNameGeoTo\":{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"firstName\":\"Nicolas\",\"lastName\":\"Tesla\",\"countryIso2\":\"US\"}}]}")
.asString();

Paramètre du corps :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}

Names Corridor exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch"

payload = {
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}

Names Corridor exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/corridorBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "corridorFromTo": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "firstLastNameGeoFrom": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryIso2": "GB"
      },
      "firstLastNameGeoTo": {
        "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryIso2": "US"
      }
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "corridorFromTo": [
        {
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "firstLastNameGeoFromGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "likelyGender": "female",
                "genderScale": 0.9667738179638148,
                "score": 20.98847600479561,
                "probabilityCalibrated": 0.9833869089819074
            },
            "firstLastNameGeoToGender": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "likelyGender": "male",
                "genderScale": -0.9915797101926913,
                "score": 30.224379416275056,
                "probabilityCalibrated": 0.9957898550963457
            },
            "firstLastNameGeoFromOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "countryOrigin": "IE",
                "countryOriginAlt": "GB",
                "countriesOriginTop": ["IE", "GB"],
                "score": 2.568304424015469,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Northern Europe",
                "probabilityCalibrated": 0.45562779224760414,
                "probabilityAltCalibrated": 0.6327518248452595
            },
            "firstLastNameGeoToOrigin": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "countryOrigin": "FR",
                "countryOriginAlt": "GR",
                "countriesOriginTop": ["FR", "GR"],
                "score": 1.454789764445522,
                "regionOrigin": "Europe",
                "topRegionOrigin": "Europe",
                "subRegionOrigin": "Western Europe",
                "probabilityCalibrated": 0.44774495967210787,
                "probabilityAltCalibrated": 0.4771001024099368
            },
            "firstLastNameGeoFromDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c43",
                "firstName": "Ada",
                "lastName": "Lovelace",
                "score": 32.41686703300403,
                "ethnicityAlt": "TrinidadTobago",
                "ethnicity": "British",
                "lifted": false,
                "countryIso2": "GB",
                "ethnicitiesTop": ["British", "TrinidadTobago"]
            },
            "firstLastNameGeoToDiaspora": {
                "script": "LATIN",
                "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c41",
                "firstName": "Nicolas",
                "lastName": "Tesla",
                "score": 1.1421954239282939,
                "ethnicityAlt": "Jewish",
                "ethnicity": "Italian",
                "lifted": false,
                "countryIso2": "US",
                "ethnicitiesTop": ["Italian", "Jewish"]
            }
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Renvoie une analyse complète d'interactions transfrontalières entre deux noms en utilisant leur contexte géographique. L'expéditeur est celui qui a initié l'interaction (from) tandis que le destinataire est celui destiné à recevoir l'interaction (to).
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Corridor.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/{countryIso2}/{firstName}/{lastName}/{countryIso2}/{firstName}/{lastName}

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
countryIso2StringRequisPays d'origine de l'expéditeur, au format ISO 3166-1 alpha-2.
firstNameStringRequisPrénom de l'expéditeur.
lastNameStringRequisNom de famille de l'expéditeur.
countryIso2StringRequisPays d'origine du destinataire, au format ISO 3166-1 alpha-2.
firstNameStringRequisPrénom du destinataire.
lastNameStringRequisNom de famille du destinataire.
Réponse
NomTypeDescriptionÉnumérateurs
idStringIdentifiant unique.
firstLastNameGeoFromGenderObjectDonnées de genre pour l'expéditeur..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.likelyGenderStringGenre le plus probable de l'expéditeur.Genres
{...}.genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
firstLastNameGeoToGenderObjectDonnées de genre pour le destinataire..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.likelyGenderStringGenre le plus probable du destinataire.Genres
{...}.genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.
firstLastNameGeoFromOriginObjectDonnées d'origine pour l'expéditeur..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.countryOriginStringPays d'origine de l'expéditeur le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countryOriginAltStringSecond pays d'origine de l'expéditeur le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countriesOriginTopArrayTop 10 des pays d'origine de l'expéditeur les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.regionOriginStringRégion d'origine de l'expéditeur la plus probable.Régions
{...}.topRegionOriginStringRégion d'origine de l'expéditeur la plus probable (classification alternative).Régions
{...}.subRegionOriginStringSous-région d'origine de l'expéditeur la plus probable.Sous régions
{...}.probabilityCalibratedNumberLa probabilité calibrée pour 'countryOrigin' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
{...}.probabilityAltCalibratedNumberLa probabilité calibrée pour 'countryOrigin' ou 'countryOriginAlt' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
firstLastNameGeoToOriginObjectDonnées d'origine pour le destinataire..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.countryOriginStringPays d'origine du destinataire le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countryOriginAltStringSecond pays d'origine du destinataire le plus probable, au format ISO 3166-1 alpha-2.Pays d'origine
{...}.countriesOriginTopArrayTop 10 des pays d'origine du destinataire les plus probables, au format ISO 3166-1 alpha-2, triés du plus probable au moins probable.Pays d'origine
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.regionOriginStringRégion d'origine du destinataire la plus probable.Régions
{...}.topRegionOriginStringRégion d'origine du destinataire la plus probable (classification alternative).Régions
{...}.subRegionOriginStringSous-région d'origine du destinataire la plus probable.Sous régions
{...}.probabilityCalibratedNumberLa probabilité calibrée pour 'countryOrigin' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
{...}.probabilityAltCalibratedNumberLa probabilité calibrée pour 'countryOrigin' ou 'countryOriginAlt' d'avoir été devinée correctement. -1 = toujours en cours de calibrage.
firstLastNameGeoFromDiasporaObjectDonnées de la diaspora pour l'expéditeur..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom de l'expéditeur renseigné.
{...}.lastNameStringNom de famille de l'expéditeur renseigné.
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.ethnicityAltStringSeconde ethnie de l'expéditeur la plus probable.Ethnicités et diasporas
{...}.ethnicityStringEthnie de l'expéditeur la plus probable.Ethnicités et diasporas
{...}.liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
{...}.countryIso2StringPays d'origine de l'expéditeur renseigné, au format ISO 3166-1 alpha-2.Pays de résidence
{...}.ethnicitiesTopArrayTop 10 des ethnies de l'expéditeur les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas
firstLastNameGeoToDiasporaObjectDonnées de la diaspora pour le destinataire..
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameStringPrénom du destinataire renseigné.
{...}.lastNameStringNom de famille du destinataire renseigné.
{...}.scoreNumberPlus élevé implique un résultat plus fiable, mais le score n'est pas normalisé. Utiliser la probabilité Calibrée si disponible.
{...}.ethnicityAltStringSeconde ethnie du destinataire la plus probable.Ethnicités et diasporas
{...}.ethnicityStringEthnie du destinataire la plus probable.Ethnicités et diasporas
{...}.liftedBooleanIndique si l'origine ethnique de la sortie est basée uniquement sur l'apprentissage automatique, ou si elle est davantage considérée comme un fait connu par une règle spécifique au pays.
{...}.countryIso2StringPays d'origine du destinataire renseigné, au format ISO 3166-1 alpha-2.Pays de résidence
{...}.ethnicitiesTopArrayTop 10 des ethnies du destinataire les plus vraisemblables, classées du plus probable au moins probable.Ethnicités et diasporas

Exemples d'intégration:

Names Corridor exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Names Corridor exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Names Corridor exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Names Corridor exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/corridor/GB/Ada/Lovelace/US/Nicolas/Tesla", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "id": null,
    "firstLastNameGeoFromGender": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "likelyGender": "female",
        "genderScale": 0.9667738179638148,
        "score": 20.98847600479561,
        "probabilityCalibrated": 0.9833869089819074
    },
    "firstLastNameGeoToGender": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "likelyGender": "male",
        "genderScale": -0.9915797101926913,
        "score": 30.224379416275056,
        "probabilityCalibrated": 0.9957898550963457
    },
    "firstLastNameGeoFromOrigin": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "countryOrigin": "IE",
        "countryOriginAlt": "GB",
        "countriesOriginTop": ["IE", "GB"],
        "score": 2.568304424015469,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Northern Europe",
        "probabilityCalibrated": 0.45562779224760414,
        "probabilityAltCalibrated": 0.6327518248452595
    },
    "firstLastNameGeoToOrigin": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "countryOrigin": "FR",
        "countryOriginAlt": "GR",
        "countriesOriginTop": ["FR", "GR"],
        "score": 1.454789764445522,
        "regionOrigin": "Europe",
        "topRegionOrigin": "Europe",
        "subRegionOrigin": "Western Europe",
        "probabilityCalibrated": 0.44774495967210787,
        "probabilityAltCalibrated": 0.4771001024099368
    },
    "firstLastNameGeoFromDiaspora": {
        "script": "LATIN",
        "id": "781cc5e4-aa61-4a04-bd14-4b512120817a",
        "firstName": "Ada",
        "lastName": "Lovelace",
        "score": 32.41666571408284,
        "ethnicityAlt": "TrinidadTobago",
        "ethnicity": "British",
        "lifted": false,
        "countryIso2": "GB",
        "ethnicitiesTop": ["British", "TrinidadTobago"]
    },
    "firstLastNameGeoToDiaspora": {
        "script": "LATIN",
        "id": "d5d87a0f-8d21-4cf6-98a2-2636a669ddd6",
        "firstName": "Nicolas",
        "lastName": "Tesla",
        "score": 1.1421870006029051,
        "ethnicityAlt": "Jewish",
        "ethnicity": "Italian",
        "lifted": false,
        "countryIso2": "US",
        "ethnicitiesTop": ["Italian", "Jewish"]
    }
}

Genre depuis un nom

L'API de vérification de nom de Namsor peut vous aider à déterminer la probabilité qu'une personne soit un homme ou une femme en fonction de son prénom. Nous proposons de nombreuses options de traitement pour la détermination du genre, le nom peut être fourni : sous la forme d'un nom complet, sous la forme d'un prénom et d'un nom . En plus du nom, vous pouvez spécifier le pays d'origine pour améliorer la précision. Notre API prend également en charge les noms chinois, les noms japonais et un grand nombre d'alphabets supplémentaires*.

Genre

La fonctionnalité Genre analyse un prénom et un nom de famille (facultatif) pour identifier le genre le plus probable avec une précision légèrement améliorée par rapport à la fonctionnalité Genre Nom Complet. L'ajout d'un prénom et d'un nom augmente la précision du genre déterminé.
La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité estimée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom unisexe.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 prénoms et noms (facultatif).
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisA list of personal names.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringRequisPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"b590b04c-da23-4f2f-a334-aee384ee420a","firstName":"Keith","lastName":"Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}

Genderize Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"b590b04c-da23-4f2f-a334-aee384ee420a\",\"firstName\":\"Keith\",\"lastName\":\"Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}

Genderize Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch"

payload = {
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}

Genderize Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8126510374561324,
            "score": 12.516892456249645,
            "probabilityCalibrated": 0.9063255187280662
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Estime le genre le plus probable à partir d'un prénom et d'un nom de famille.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/gender/{firstName}/{lastName}

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genderize Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genderize Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genderize Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/gender/Keith/Haring", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "b590b04c-da23-4f2f-a334-aee384ee420a",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8126510374561324,
    "score": 12.516892456249645,
    "probabilityCalibrated": 0.9063255187280662
}

Genre (Geo)

La fonctionnalité Genre (Geo) analyse un prénom, un nom de famille (facultatif) et un pays de résidence pour identifier le genre le plus probable avec une précision améliorée par rapport à la fonctionnalité Genre. L'ajout d'un prénom et d'un nom de famille augmente la précision du genre estimé.
La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité. Si la probabilité estimée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom unisexe.

  • Description : Renvoie le genre le plus vraisemblable d'un maximum de 100 prénoms et noms de famille (facultatif) en utilisant leur contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre (Geo).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringRequisPrénom.
[{...}].lastNameStringOptionelNom de famille.
[{...}].countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"27fb45db-eddf-40d0-95c1-de9978a166b0","firstName":"Keith","lastName":"Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}

Genderize Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"27fb45db-eddf-40d0-95c1-de9978a166b0\",\"firstName\":\"Keith\",\"lastName\":\"Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}

Genderize Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch"

payload = {
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}

Genderize Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
      "firstName": "Keith",
      "lastName": "Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
            "firstName": "Keith",
            "lastName": "Haring",
            "likelyGender": "male",
            "genderScale": -0.8889514731555574,
            "score": 16.03594419932244,
            "probabilityCalibrated": 0.9444757365777787
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Estime le genre le plus probable à partir d'un prénom et d'un nom de famille, enrichi d'un contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre (Geo).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/{firstName}/{lastName}/{countryIso2}

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
countryIso2StringRequisPays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
firstNameStringPrénom renseigné.
lastNameStringNom de famille renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Name Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genderize Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genderize Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genderize Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderGeo/Keith/Haring/US", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "27fb45db-eddf-40d0-95c1-de9978a166b0",
    "firstName": "Keith",
    "lastName": "Haring",
    "likelyGender": "male",
    "genderScale": -0.8889514731555574,
    "score": 16.03594419932244,
    "probabilityCalibrated": 0.9444757365777787
}

Genre Nom Complet

La fonctionnalité Genre Nom Complet analyse un nom complet non divisé (prénom et nom de famille) pour identifier le genre le plus probable.
La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité estimée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom non-genré.

information

Si le nom et le prénom sont clairement identifiables, la fonction Genre sera légèrement plus précise.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 noms complets non divisés.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms personnels complets.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"0f472330-11a9-49ad-a0f5-bcac90a3f6bf","name":"Keith Haring"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}

Genderize Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"0f472330-11a9-49ad-a0f5-bcac90a3f6bf\",\"name\":\"Keith Haring\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}

Genderize Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch"

payload = {
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}

Genderize Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
      "name": "Keith Haring"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8744219712791637,
            "score": 11.2727995452283,
            "probabilityCalibrated": 0.9372109856395818
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/{name}

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genderize Full Name exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genderize Full Name exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genderize Full Name exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFull/Keith%20Haring", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "0f472330-11a9-49ad-a0f5-bcac90a3f6bf",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8744219712791637,
    "score": 11.2727995452283,
    "probabilityCalibrated": 0.9372109856395818
}

Genre Nom Complet (Geo)

La fonctionnalité Genre Nom Complet (Geo) analyse un nom complet non divisé (prénom et nom de famille) accompagné d'un pays de résidence, afin d'identifier le genre le plus probable avec une meilleure précision que la fonctionnalité de base Genre Nom Complet. La fonctionnalité renvoie le genre le plus probable accompagné d'une probabilité calibrée. Si la probabilité renvoyée est comprise entre 45 % et 55 %, le nom peut être interprété comme un nom non-genré.

information

Si le nom et le prénom sont clairement identifiables, la fonction Genre Nom Geo sera légèrement plus précise.

  • Description : Renvoie le genre le plus probable d'un maximum de 100 noms complets non divisés, en se basant sur un contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet (Geo).

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
personalNamesArray of objectsRequisUne liste de noms complets personnels avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis genrés.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet renseigné.
[{...}].likelyGenderStringGenre le plus probable.Genres
[{...}].genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
[{...}].probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name Geo exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f","name":"Keith Haring","countryIso2":"US"}]}'

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}

Genderize Full Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f\",\"name\":\"Keith Haring\",\"countryIso2\":\"US\"}]}")
.asString();

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}

Genderize Full Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch"

payload = {
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}

Genderize Full Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeoBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :

{
  "personalNames": [
    {
      "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
            "name": "Keith Haring",
            "likelyGender": "male",
            "genderScale": -0.8716298606148474,
            "score": 11.225679376737641,
            "probabilityCalibrated": 0.9358149303074237
        }
    ]
}
information

Pour les requêtes avec une méthode GET tous les paramètres sont requis. Pour plus de facilité nous vous recommandons d'utiliser la méthode POST.

  • Description : Identifie le genre le plus probable d'un nom complet non divisé, selon son contexte géographique.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Genre Nom Complet (Geo).

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/{name}/{countryIso2}

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
countryIso2StringRequisPays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique.
nameStringNom complet renseigné.
likelyGenderStringGenre le plus probable.Genres
genderScaleNumberÉchelle de genre allant de -1 (masculin) à +1 (féminin).
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.
probabilityCalibratedNumberPlus élevé implique un résultat plus fiable, allant de 0 à 1.

Exemples d'intégration:

Genderize Full Name Geo exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Genderize Full Name Geo exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.asString();

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Genderize Full Name Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US"

headers = {
  "X-API-KEY": "your-api-key",
 "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Genderize Full Name Geo exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/genderFullGeo/Keith%20Haring/US", {
  "method": "GET",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json"
  }
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "script": "LATIN",
    "id": "3a2d203a-a6a4-42f9-acd1-1b5c56c7d39f",
    "name": "Keith Haring",
    "likelyGender": "male",
    "genderScale": -0.8716298606148474,
    "score": 11.225679376737641,
    "probabilityCalibrated": 0.9358149303074237
}

Type des noms

Namsor fournit une API spécialisée dans la détermination du type d'un nom propre. Elle est formée pour analyser les noms propres et déduire s'il s'agit de noms personnels (anthroponyme), de noms de marques (toponyme) ou de noms de lieux. Différenciez les individus des entreprises en fonction de leur nom afin d'automatiser les processus, d'évaluer les références aux noms ou d'obtenir une meilleure connaissance d'un public. Pour obtenir de meilleurs résultats, vous pouvez indiquer le pays d'origine du nom.

Type Nom

La fonctionnalité Type Nom analyse un nom propre pour déterminer s'il s'agit du nom d'une personne (anthroponyme), d'un nom géographique (toponyme), de l'alias d'une personne (pseudonyme), ou le nom d'une marque. Nous vous recommandons de soumettre le nom complet.

  • Description : Estime le type d'un ensemble de noms propres (jusqu'à 100). Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
  • Precision :Jauge de précision
  • Coût : 1 crédit par nom.
  • Tester : Fonctionnalité Type Nom.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch

En-tête de requête

PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
Corps de la requête
NomTypeRequisDescription
properNounsArray of objectsRequisA list of proper names.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisUn nom propre (personne, marque, etc.).
Réponse
NomTypeDescriptionÉnumérateurs
properNounsArray of objectsA list of commonTypeized names..
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom propre renseigné.
[{...}].commonTypeStringType le plus probable du nom propre.Type du nom
[{...}].commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type exemple de code pour shell:

curl --request POST \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"properNouns":[{"id":"e630dda5-13b3-42c5-8f1d-648aa8a21c42","name":"Zippo"}]}'

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}

Name Type exemple de code pour java:

HttpResponse<String> response = Unirest.post("https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"properNouns\":[{\"id\":\"e630dda5-13b3-42c5-8f1d-648aa8a21c42\",\"name\":\"Zippo\"}]}")
.asString();

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}

Name Type exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch"

payload = {
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}
headers = {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Paramètre du corps :

{
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
}

La commande ci-dessus renvoie un JSON structuré comme ceci :

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Zippo",
            "commonType": "brand-name",
            "commonTypeAlt": "toponym",
            "score": 7.717552576402805
        }
    ]
}

Name Type exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch", {
  "method": "POST",
  "headers": {
    "X-API-KEY": "your-api-key",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  "body": JSON.stringify({
  "properNouns": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Zippo"
    }
  ]
})
});

if (response.ok) {
  const data = await response.json(); // Extract JSON data from response
  console.log(data); // View data in the console
} else {
  console.error("The request failed with status:", response.status, response);
}

Paramètre du corps :