API Diaspora & ethnicité – Analyser un nom pour identifier l'origine ethnique
L'API Diaspora & Ethnicité de Namsor fournit des insights détaillés sur l'origine ethnique probable d'une personne ou son affiliation diasporique basée sur son nom et un contexte local tel que le pays de résidence. Elle prend en charge les entrées séparées (prénom et nom de famille) et les chaînes de nom complet, facilitant l'adaptation à vos jeux de données existants. Cette flexibilité simplifie l'intégration et accélère votre processus d'analyse.
Que vous meniez des recherches académiques, analysiez des tendances démographiques, ou développiez des produits numériques inclusifs, cette API aide à identifier la diversité culturelle avec une grande précision. Elle est particulièrement efficace dans les sociétés multiculturelles où la détection d'origine standard peut s'avérer insuffisante. Le modèle d'ethnicité basé sur les noms de Namsor est entraîné sur des données mondiales riches—garantissant des résultats cohérents et précis à travers les régions et les langues.
600+contributions à la recherche
99,99%de couverture des noms
11Md milliardsde noms traités
Diaspora
Diaspora à partir de prénom (optionnel), nom de famille , code du pays (optionnel).
{
"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
}Diaspora analyse un nom pour identifier l'ethnicité ou diaspora la plus probable, avec une précision légèrement supérieure à la fonctionnalité Diaspora Nom Complet. Fournir à la fois un prénom et un nom de famille, ainsi qu'un contexte local (ex : pays de résidence, pays de travail, etc.), améliore significativement la précision. La réponse inclut l'ethnicité ou diaspora la plus probable et une liste classée des 10 premières, chacune accompagnée d'une probabilité calibrée.
Lorsqu'aucune valeur n'est fournie pour countryIso2, Diaspora utilise les États-Unis US comme contexte local par défaut
- Coût: 20 crédits par nom.
- 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.
- Plus d'informations sur : Diaspora
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaBatch| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
Pour obtenir une clé d'API gratuite, veuillez créer un compte.
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].firstName | String | Optionel | Prénom. |
[{...}].lastName | String | Requis | Nom de famille. |
[{...}].countryIso2 | String | Optionel | Pays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms soumis avec leurs ethnies estimées. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].firstName | String | Prénom renseigné. | |
[{...}].lastName | String | Nom de famille renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].ethnicityAlt | String | Seconde ethnie la plus probable. | Ethnicités et diasporas |
[{...}].ethnicity | String | Ethnie la plus probable. | Ethnicités et diasporas |
[{...}].lifted | Boolean | Indique 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. | |
[{...}].countryIso2 | String | Submitted Pays de résidence, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].ethnicitiesTop | Array | Top 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable. | Ethnicités et diasporas |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True). | |
[{...}].religion | String | Religion au sein de la diaspora la plus probable (ethnicity). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion au sein de la seconde diaspora la plus probable (ethnicityAlt). | Religions |
[{...}].pct | Number | Pourcentage 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 },
],
}Diaspora Nom Complet
Diaspora à partir de nom , code du pays .
{
"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
}Diaspora Nom Complet analyse un nom complet non séparé (prénom et nom de famille combinés) pour déterminer l'ethnicité ou diaspora la plus probable. La réponse inclut le résultat le plus probable ainsi qu'une liste classée des 10 premières ethnicités ou diasporas, chacune accompagnée d'une probabilité calibrée.
Si le prénom et le nom de famille sont clairement identifiables, la fonctionnalité Diaspora sera légèrement plus précise.
- Coût: 20 crédits par nom.
- Description : Estime les ethnicités/diasporas les plus vraisemblable d'un ensemble de noms complets non divisés et de pays de résidence.
- Plus d'informations sur : Diaspora Nom Complet
Requête HTTP
https://v2.namsor.com/NamSorAPIv2/api2/json/diasporaFullBatch| Propriété | Requis | Description |
|---|---|---|
X-API-KEY | Requis | Votre clé d'API Namsor |
Pour obtenir une clé d'API gratuite, veuillez créer un compte.
| Nom | Type | Requis | Description |
|---|---|---|---|
personalNames | Array of objects | Requis | Une liste de noms complets personnels avec leur pays de résidence. |
[{...}].id | String | Optionel | Identifiant unique. |
[{...}].name | String | Requis | Nom complet non divisé (prénom et nom de famille). |
[{...}].countryIso2 | String | Requis | Pays de résidence, au format ISO 3166-1 alpha-2. "US" par défault (si aucune valeur indiquée). |
| Nom | Type | Description | Énumérateurs |
|---|---|---|---|
personalNames | Array of objects | Liste des noms complets soumis avec leurs ethnies estimées. | |
[{...}].script | String | Nom de l'écriture utilisée pour le nom, au format ISO 15924. | Écritures |
[{...}].id | String | Identifiant unique fourni. | |
[{...}].name | String | Nom complet renseigné. | |
[{...}].score | Number | Plus élevé implique un résultat plus fiable, le score n'est pas normalisé. | |
[{...}].ethnicityAlt | String | Seconde ethnie la plus probable. | Ethnicités et diasporas |
[{...}].ethnicity | String | Ethnie la plus probable. | Ethnicités et diasporas |
[{...}].lifted | Boolean | Indique 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. | |
[{...}].countryIso2 | String | Submitted Pays de résidence, au format ISO 3166-1 alpha-2. | Pays de résidence |
[{...}].ethnicitiesTop | Array | Top 10 des ethnies les plus vraisemblables, classées du plus probable au moins probable. | Ethnicités et diasporas |
[{...}].probabilityCalibrated | Number | La probabilité calibrée que 'ethnicity' ait été devinée correctement. -1 = toujours en cours de calibrage. | |
[{...}].probabilityAltCalibrated | Number | La probabilité calibrée que 'ethnicity' ou 'ethnicityAlt' aient été devinée correctement. -1 = toujours en cours de calibrage. | |
| Optionnel : X-OPTION-RELIGION-STATS = True | |||
[{...}].religionStats | Array of objects | Statistiques religieuses pour la diaspora la plus probable. Est renvoyé uniquement si l'option de statistiques religieuses est activée (X-OPTION-RELIGION-STATS : True). | |
[{...}].religion | String | Religion au sein de la diaspora la plus probable (ethnicity). | Religions |
[{...}].pct | Number | Pourcentage de la population pratiquant cette religion au sein de la diaspora la plus probable (ethnicity). | |
[{...}].religionStatsAlt | Array of objects | Statistiques 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). | |
[{...}].religion | String | Religion au sein de la seconde diaspora la plus probable (ethnicityAlt). | Religions |
[{...}].pct | Number | Pourcentage 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 },
],
}