Namsor

API Ethno-raciale US – Classifier les noms selon la taxonomie du recensement américain

L'API Ethno-raciale US de Namsor prédit la l'origine ethno-raciale la plus probable d'une personne selon les standards établis par la taxonomie officielle du recensement des États-Unis. Vous pouvez soumettre un nom soit comme une chaîne complète soit sous la forme de prénom et nom de famille. Notre système gère les deux formats avec facilité, rendant l'intégration simple et flexible.


Cette API est particulièrement utile pour les organisations travaillant sur l'analyse de diversité, les politiques publiques, la conformité ou les projets de recherche aux États-Unis. Elle associe les noms aux catégories démographiques officielles telles que Blanc, Noir ou Afro-Américain, Asiatique, Hispanique ou Latino, Amérindien ou Natif d'Alaska, entre autres. Basée sur d'importants jeux de données américains et des algorithmes avancés de reconnaissance de noms, Namsor propose une classification ethnique précise et éthique tout en respectant la vie privée.

600+contributions à la recherche

99,99%de couverture des noms

11Md milliardsde noms traités

Ethnie US

Ethnie 'raciale' US à partir de prénom (optionnel), nom de famille (optionnel), code du pays (optionnel).

Sélectionnez une taxonomie :
Recenseurs pour l'ethnie 'raciale' estimée. Énumérateurs d'ethnies 'raciales' aux États-Unis.
Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
{
    "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 analyse un prénom et/ou nom de famille pour déterminer la race américaine la plus probable, avec une précision légèrement supérieure à la fonctionnalité Full Name US Race. Fournir à la fois un nom complet et un pays de résidence améliore la précision. L'ethnicité 'raciale' US fait référence aux classifications définies par la Taxonomie du recensement des États-Unis.

  • Coût: 10 crédits par nom.
  • Description : Estime l'ethnie 'raciale' US jusqu'à 100 prénoms et/ou noms de famille.
  • Plus d'informations sur : Ethnie US

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.
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

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é dans l'utilisation de nos requêtes, nous 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.
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique 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 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 Nom Complet

Ethnie 'raciale' US à partir de nom , code du pays (optionnel).

Sélectionnez une taxonomie :
Recenseurs pour l'ethnie 'raciale' estimée. Énumérateurs d'ethnies 'raciales' aux États-Unis.
Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
{
    "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
}

Ethnie US (ZIP) s'appuie sur la fonctionnalité de base Ethnie US en incorporant des données de code postal pour améliorer la précision. Elle analyse un prénom et/ou nom de famille — optionnellement avec un pays de résidence — pour identifier l'ethnicité 'raciale' américaine la plus probable. L'ethnicité 'raciale' US fait référence aux classifications définies par la Taxonomie du recensement des États-Unis.

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.
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

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é dans l'utilisation de nos requêtes, nous 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.
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Paramètres de requête
NomTypeRequisDescription
nameStringRequisNom complet non divisé (prénom et nom de famille).
countryIso2StringRequisPays de résidence, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
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 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
}

Ethnie US (ZIP)

Ethnie 'raciale' US à partir de prénom (optionnel), nom de famille (optionnel), code du pays (optionnel), code postal à 5 ​​chiffres .

Sélectionnez une taxonomie :
Recenseurs pour l'ethnie 'raciale' estimée. Énumérateurs d'ethnies 'raciales' aux États-Unis.
Pour les noms internationaux (non-résidents américains), veuillez choisir 4 classes.
{
    "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 analyse un nom complet non séparé (prénom et nom de famille combinés) pour déterminer l'ethnicité 'raciale' américaine la plus probable. L'ethnicité 'raciale' US fait référence aux classifications définies par la Taxonomie du recensement des États-Unis.

information

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

  • Coût: 10 crédits par nom.
  • Description : Estime l'ethnie 'raciale' US jusqu'à 100 prénoms et/ou noms de famille, avec une précision améliorée grâce à un code postal de résidence.
  • Plus d'informations sur : Ethnie US (ZIP)

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.
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

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
        }
    ]
}
  • Coût: 10 crédits par nom.
  • Description : Estime l'ethnie 'raciale' américaine à partir d'un prénom et/ou d'un nom de famille et avec une précision améliorée grâce à un code postal de résidence.
information

Pour les requêtes avec une méthode GET, tous les paramètres sont requis. Pour plus de facilité dans l'utilisation de nos requêtes, nous 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.
information

Pour obtenir une clé d'API gratuite, veuillez créer un compte.

Paramètres de requête
NomTypeRequisDescription
firstNameStringRequisPrénom.
lastNameStringRequisNom de famille.
countryIso2StringRequisPays 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
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 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
}

Section suivante

API Noms Indiens – Détectez caste, religion et région d'origine