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 avec une précision légèrement améliorée par rapport à la fonctionnalité Origine Nom Complet. 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.
  • Precision :Jauge de précision
  • 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 objectsRequisUne liste de noms personnels.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets 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.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].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", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

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", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

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", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

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", "EE", "SE", "DK", "MY", "ID", "KH"],
            "score": 10.255274142073363,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.7724670883776785,
            "probabilityAltCalibrated": 0.8719112661893521
        }
    ]
}

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.
  • Precision :Jauge de précision
  • 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.
Optionnel : X-OPTION-RELIGION-STATS = True
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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "firstName": "Keith",
    "lastName": "Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "EE", "SE", "DK", "MY", "ID", "KH"],
    "score": 10.255274142073363,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.7724670883776785,
    "probabilityAltCalibrated": 0.8719112661893521
}

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 },
  ],
}

Origine Nom Complet

La fonctionnalité Origine Nom Complet analyse nom complet non divisé (prénom et nom de famille) pour identifier le pays d'origine.
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".

information

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

  • Description : Renvoie le pays d'origine le plus probable d'un maximum de 100 noms complets non divisés.
  • Precision :Jauge de précision
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine Nom Complet.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/originFullBatch
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 complets.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom 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.
[{...}].nameStringNom complet non divisé (prénom et nom de famille).
[{...}].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.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].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:

Full Name Origin exemple de code pour shell:

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

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

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 },
  ],
}

Full Name Origin exemple de code pour java:

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

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

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 },
  ],
}

Full Name Origin exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "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": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

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 },
  ],
}

Full Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/originFullBatch", {
  "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",
      "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": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
      "name": "Keith Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Keith Haring",
            "countryOrigin": "GB",
            "countryOriginAlt": "IE",
            "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
            "score": 11.240061482140302,
            "regionOrigin": "Europe",
            "topRegionOrigin": "Europe",
            "subRegionOrigin": "Northern Europe",
            "probabilityCalibrated": 0.8369777938445658,
            "probabilityAltCalibrated": 0.9297055536113793
        }
    ]
}

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 nom complet non divisé.
  • Precision :Jauge de précision
  • Coût : 10 crédits par nom.
  • Tester : Fonctionnalité Origine Nom Complet.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/{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
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 fourni.
nameStringNom complet 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.
Optionnel : X-OPTION-RELIGION-STATS = True
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:

Full Name Origin exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

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 },
  ],
}

Full Name Origin exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

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 },
  ],
}

Full Name Origin exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

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 },
  ],
}

Full Name Origin exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/originFull/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": "76d53c84-623b-4e8c-9414-3e68b9b1d171",
    "name": "Keith Haring",
    "countryOrigin": "GB",
    "countryOriginAlt": "IE",
    "countriesOriginTop": ["GB", "IE", "DE", "NL", "DK", "SE", "CH", "EE", "MY", "HK"],
    "score": 11.240061482140302,
    "regionOrigin": "Europe",
    "topRegionOrigin": "Europe",
    "subRegionOrigin": "Northern Europe",
    "probabilityCalibrated": 0.8369777938445658,
    "probabilityAltCalibrated": 0.9297055536113793
}

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 avec une précision légèrement améliorée par rapport à la fonctionnalité Diaspora Nom Complet. 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.
  • Precision :Jauge de précision
  • 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.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].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": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

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": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

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": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

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": 8.653234788906794,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
            "probabilityCalibrated": 0.5197497794419499,
            "probabilityAltCalibrated": 0.5197497794419499
        }
    ]
}

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.
  • Precision :Jauge de précision
  • 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.
Optionnel : X-OPTION-RELIGION-STATS = True
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": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

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": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

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": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

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": 8.653234788906794,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Danish", "Irish", "Norwegian", "Swedish", "Jewish", "NativeHawaiian", "Austrian"],
    "probabilityCalibrated": 0.5197497794419499,
    "probabilityAltCalibrated": 0.5197497794419499
}

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 },
  ],
}

Diaspora Nom Complet

La fonctionnalité Diaspora Nom Complet analyse un nom complet non divisé (prénom et nom de famille) pour identifier l'ethnie/diaspora la plus probable.
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.

information

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

  • Description : Estime les ethnicités/diasporas les plus vraisemblable d'un ensemble de noms complets non divisés et de pays de résidence.
  • Precision :Jauge de précision
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora Nom Complet.

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch
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 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. "US" par défault (si aucune valeur indiquée).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets soumis avec leurs ethnies estimées.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet 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.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].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:

Full Name Diaspora exemple de code pour shell:

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

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

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 },
  ],
}

Full Name Diaspora exemple de code pour java:

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

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

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 },
  ],
}

Full Name Diaspora exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

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 },
  ],
}

Full Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch", {
  "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",
      "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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "0d7d6417-0bbb-4205-951d-b3473f605b56",
            "name": "Keith Haring",
            "score": 1.9177978014400305,
            "ethnicityAlt": "British",
            "ethnicity": "German",
            "lifted": false,
            "countryIso2": "US",
            "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
            "probabilityCalibrated": 0.29971840123154375,
            "probabilityAltCalibrated": 0.35544175296700403
        }
    ]
}

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 nom complet non divisé et d'un pays de résidence.
  • Precision :Jauge de précision
  • Coût : 20 crédits par nom.
  • Tester : Fonctionnalité Diaspora Nom Complet.

Requête HTTP

requête http
GET
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/{countryIso2}/{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
countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée).
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é.
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.
Optionnel : X-OPTION-RELIGION-STATS = True
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:

Full Name Diaspora exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

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 },
  ],
}

Full Name Diaspora exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

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 },
  ],
}

Full Name Diaspora exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

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 },
  ],
}

Full Name Diaspora exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFull/US/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": "0d7d6417-0bbb-4205-951d-b3473f605b56",
    "name": "Keith Haring",
    "score": 1.9177978014400305,
    "ethnicityAlt": "British",
    "ethnicity": "German",
    "lifted": false,
    "countryIso2": "US",
    "ethnicitiesTop": ["German", "British", "Dutch", "Irish", "Norwegian", "Danish", "Swedish", "Swiss", "Austrian", "NativeHawaiian"],
    "probabilityCalibrated": 0.29971840123154375,
    "probabilityAltCalibrated": 0.35544175296700403
}

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 prénom et ou un nom de famille pour identifier l'ethnie 'raciale' US la plus probable avec une précision légèrement améliorée par rapport à la fonctionnalité Ethnie US Nom Complet. 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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}
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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Ethnie US (ZIP)

La fonctionnalité Ethnie US (ZIP) analyse un prénom et/ou un nom de famille 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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}

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": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 3.9546190943560813,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.619185913005526,
            "probabilityAltCalibrated": 0.7534347105665851
        }
    ]
}
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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

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": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 3.9546190943560813,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.619185913005526,
    "probabilityAltCalibrated": 0.7534347105665851
}

Ethnie US Nom Complet

La fonctionnalité Ethnie US Nom Complet analyse un nom pour identifier l'ethnie 'raciale' US la plus probable.
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

information

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

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatch
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 complets avec leur pays de résidence.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
[{...}].countryIso2StringOptionelPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets renseignés enrichis de leur ethnie 'raciale'.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom complet 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:

Full Name US Race exemple de code pour shell:

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

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}

Full Name US Race exemple de code pour java:

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

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}

Full Name US Race exemple de code pour python:

import requests

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

payload = {
  "personalNames": [
    {
      "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}

Full Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFullBatch", {
  "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",
      "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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
      "name": "Keith Haring",
      "countryIso2": "US"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
            "name": "Keith Haring",
            "raceEthnicityAlt": "B_NL",
            "raceEthnicity": "W_NL",
            "score": 6.493299531249249,
            "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
            "probabilityCalibrated": 0.7239234645232184,
            "probabilityAltCalibrated": 0.8814496032861949
        }
    ]
}
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/usRaceEthnicityFull/{name}
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
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é.
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:

Full Name US Race exemple de code pour shell:

curl --request GET \ 
--url https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Full Name US Race exemple de code pour java:

HttpResponse<String> response = Unirest.get("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Full Name US Race exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Full Name US Race exemple de code pour javascript:

const response = await fetch("https://v2.namsor.com/NamSorAPIv2/api2/json/usRaceEthnicityFull/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": "85dd5f48-b9e1-4019-88ce-ccc7e56b763f",
    "name": "Keith Haring",
    "raceEthnicityAlt": "B_NL",
    "raceEthnicity": "W_NL",
    "score": 6.493299531249249,
    "raceEthnicitiesTop": ["W_NL", "B_NL", "A", "HL"],
    "probabilityCalibrated": 0.7239234645232184,
    "probabilityAltCalibrated": 0.8814496032861949
}

Pays de Residence

La fonctionnalité Pays de Residence analyse un prénom et/ou un nom de famille pour identifier son pays de résidence avec une précision légèrement améliorée par rapport à la fonctionnalité Pays de Residence Nom Complet. L'ajout d'un prénom et d'un nom de famille augmente la précision du genre déterminé.
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 et/ou noms de famille.
  • 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/countryFnLnBatch
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.
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstNameStringOptionelPrénom.
[{...}].lastNameStringOptionelNom de famille.
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.
[{...}].firstNameStringPrénom renseigné.
[{...}].lastNameStringNom de famille 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.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].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/countryFnLnBatch \
--header 'X-API-KEY: your-api-key' \
--header 'Accept: application/json'
--header 'Content-Type: application/json' \
--data '{"personalNames":[{"id":"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4","firstName":"Keith","lastName":"Haring"}]}'

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

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/countryFnLnBatch")
.header("X-API-KEY", "your-api-key")
.header("Accept", "application/json")
.header("Content-Type", "application/json")
.body("{\"personalNames\":[{\"id\":\"9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4\",\"firstName\":\"Keith\",\"lastName\":\"Haring\"}]}")
.asString();

Paramètre du corps :

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

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

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/countryFnLnBatch"

payload = {
  "personalNames": [
    {
      "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

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/countryFnLnBatch", {
  "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",
      "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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
      "firstName": "Keith",
      "lastName": "Haring"
    }
  ]
}

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

{
    "personalNames": [
        {
            "script": "LATIN",
            "id": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
            "firstName": "Keith",
            "lastName": "Haring",
            "score": 1.0276301745383112,
            "country": "AU",
            "countryAlt": "GB",
            "region": "Oceania",
            "topRegion": "Oceania",
            "subRegion": "Australia and New Zealand",
            "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
            "probabilityCalibrated": 0.2748899815464943,
            "probabilityAltCalibrated": 0.3641355716648853
        }
    ]
}

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 et/ou d'un nom de famille.
  • 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/countryFnLn/{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.
firstNameStringPrénom renseigné.
lastNameStringNom de famille 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.
Optionnel : X-OPTION-RELIGION-STATS = True
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/countryFnLn/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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

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/countryFnLn/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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

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/countryFnLn/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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

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/countryFnLn/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": "9a3283bd-4efb-4b7b-906c-e3f3c03ea6a4",
    "firstName": "Keith",
    "lastName": "Haring",
    "score": 1.0276301745383112,
    "country": "AU",
    "countryAlt": "GB",
    "region": "Oceania",
    "topRegion": "Oceania",
    "subRegion": "Australia and New Zealand",
    "countriesTop": ["AU", "GB", "US", "CA", "NZ", "TT", "SG", "JM", "IE", "DE"],
    "probabilityCalibrated": 0.2748899815464943,
    "probabilityAltCalibrated": 0.3641355716648853
}

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 },
  ],
}

Pays de Residence Nom Complet

La fonctionnalité Pays de Residence Nom Complet analyse un nom complet non divisé (prénom et nom de famille) 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.

information

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

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 objectsRequisUne liste de noms complets.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisNom complet non divisé (prénom et nom de famille).
Réponse
NomTypeDescriptionÉnumérateurs
personalNamesArray of objectsListe des noms complets 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 complet 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.
Optionnel : X-OPTION-RELIGION-STATS = True
[{...}].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:

Full 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": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

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 },
  ],
}

Full 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": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

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 },
  ],
}

Full 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": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

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 },
  ],
}

Full 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": 2.051795198803658,
            "country": "GB",
            "countryAlt": "NZ",
            "region": "Europe",
            "topRegion": "Europe",
            "subRegion": "Northern Europe",
            "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
            "probabilityCalibrated": 0.22823337808846267,
            "probabilityAltCalibrated": 0.24281407862260063
        }
    ]
}

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.

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
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é.
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.
Optionnel : X-OPTION-RELIGION-STATS = True
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:

Full 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": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

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 },
  ],
}

Full 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": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

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 },
  ],
}

Full 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": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

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 },
  ],
}

Full 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": 2.051795198803658,
    "country": "GB",
    "countryAlt": "NZ",
    "region": "Europe",
    "topRegion": "Europe",
    "subRegion": "Northern Europe",
    "countriesTop": ["GB", "NZ", "US", "AU", "IE", "CA", "JM", "TT", "SG", "DE"],
    "probabilityCalibrated": 0.22823337808846267,
    "probabilityAltCalibrated": 0.24281407862260063
}

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 objectsRequisUne liste de paires de noms, avec le code du pays (nameFrom -> nameTo).
[{...}].idStringOptionelIdentifiant unique.
[{...}].firstLastNameGeoFromObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequis.
{...}.lastNameStringRequis.
{...}.countryIso2StringRequis.
[{...}].firstLastNameGeoToObjectRequis.
{...}.idStringOptionelIdentifiant unique.
{...}.firstNameStringRequis.
{...}.lastNameStringRequis.
{...}.countryIso2StringRequis.
Réponse
NomTypeDescriptionÉnumérateurs
corridorFromToArray of objectsUne liste de paires de noms classifiés.
[{...}].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.
{...}.firstNameString.
{...}.lastNameString.
{...}.likelyGenderString.Genres
{...}.genderScaleNumber.
{...}.scoreNumber.
{...}.probabilityCalibratedNumber.
[{...}].firstLastNameGeoToGenderObjectDonnées de genre pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.likelyGenderString.Genres
{...}.genderScaleNumber.
{...}.scoreNumber.
{...}.probabilityCalibratedNumber.
[{...}].firstLastNameGeoFromOriginObjectDonnées d'origine pour l'expéditeur.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.countryOriginString.Pays d'origine
{...}.countryOriginAltString.Pays d'origine
{...}.countriesOriginTopArray.Pays d'origine
{...}.scoreNumber.
{...}.regionOriginString.Régions
{...}.topRegionOriginString.Régions
{...}.subRegionOriginString.Sous régions
{...}.probabilityCalibratedNumber.
{...}.probabilityAltCalibratedNumber.
[{...}].firstLastNameGeoToOriginObjectDonnées d'origine pour le destinataire.
{...}.scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
{...}.idStringIdentifiant unique.
{...}.firstNameString.
{...}.lastNameString.
{...}.countryOriginString.Pays d'origine
{...}.countryOriginAltString.Pays d'origine
{...}.countriesOriginTopArray.Pays d'origine
{...}.scoreNumber.
{...}.regionOriginString.Régions
{...}.topRegionOriginString.Régions
{...}.subRegionOriginString.Sous régions
{...}.probabilityCalibratedNumber.
{...}.probabilityAltCalibratedNumber.
[{...}].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.
{...}.firstNameString.
{...}.lastNameString.
{...}.scoreNumber.
{...}.ethnicityAltString.Ethnicités et diasporas
{...}.ethnicityString.Ethnicités et diasporas
{...}.liftedBoolean.
{...}.countryIso2String.Pays de résidence
{...}.ethnicitiesTopArray.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.
{...}.firstNameString.
{...}.lastNameString.
{...}.scoreNumber.
{...}.ethnicityAltString.Ethnicités et diasporas
{...}.ethnicityString.Ethnicités et diasporas
{...}.liftedBoolean.
{...}.countryIso2String.Pays de résidence
{...}.ethnicitiesTopArray.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":