Namsor

Type API – Déterminer le type d'un nom propre

L'API de reconnaissance de type de nom de Namsor classifie avec précision les noms propres en catégories telles que les noms de personnes (anthroponymes), les noms de marques, les noms géographiques (toponymes), ou les pseudonymes. En analysant les modèles de nommage et en considérant les informations régionales, notre API fournit des classifications précises, améliorant la qualité des données et supportant diverses applications.


Que vous traitiez des noms pour le nettoyage de données, la reconnaissance d'entités, ou l'analyse de marché, cette API s'adapte parfaitement à votre format de données. Fournir un pays d'origine peut améliorer davantage la précision, particulièrement pour les noms issus de cultures où les conventions de nommage varient. Cette fonctionnalité est précieuse pour les applications de normalisation de données, de profilage utilisateur, et de recherche interculturelle.

Type Nom

Type de nom à partir de nom propre .

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Bic",
    "commonType": "brand-name",
    "commonTypeAlt": "anthroponym",
    "score": 4.758963741392455
}

Type Nom analyse un nom propre pour déterminer s'il s'agit du nom d'une personne (anthroponyme), d'un lieu géographique (toponyme), d'un alias personnel (pseudonyme), ou d'un nom de marque. Pour de meilleurs résultats, nous recommandons de soumettre le nom complet lorsque applicable.

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

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

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

Corps de la requête
NomTypeRequisDescription
properNounsArray of objectsRequisUne liste de noms propres.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisUn nom propre (personne, marque, etc.).
Réponse
NomTypeDescriptionÉnumérateurs
properNounsArray of objectsUne liste de noms propres avec leur type estimé.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom propre renseigné.
[{...}].commonTypeStringType le plus probable du nom propre.Type du nom
[{...}].commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type exemple de code pour shell:

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

Paramètre du corps :

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

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

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

Name Type exemple de code pour java:

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

Paramètre du corps :

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

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

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

Name Type exemple de code pour python:

import requests

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

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

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

print(response.text)

Paramètre du corps :

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

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

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

Name Type exemple de code pour javascript:

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

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 :

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

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Bic",
            "commonType": "brand-name",
            "commonTypeAlt": "anthroponym",
            "score": 4.758963741392455
        }
    ]
}
  • Coût: 1 crédit par nom.
  • Description : Détermine le type d'un nom propre. Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
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/nameType/{name}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

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

Paramètres de requête
NomTypeRequisDescription
nameStringRequisUn nom propre (personne, marque, etc.).
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom propre renseigné.
commonTypeStringType le plus probable du nom propre.Type du nom
commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type exemple de code pour shell:

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

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Bic",
    "commonType": "brand-name",
    "commonTypeAlt": "anthroponym",
    "score": 4.758963741392455
}

Name Type exemple de code pour java:

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

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Bic",
    "commonType": "brand-name",
    "commonTypeAlt": "anthroponym",
    "score": 4.758963741392455
}

Name Type exemple de code pour python:

import requests

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

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

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

print(response.text)

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Bic",
    "commonType": "brand-name",
    "commonTypeAlt": "anthroponym",
    "score": 4.758963741392455
}

Name Type exemple de code pour javascript:

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

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

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Bic",
    "commonType": "brand-name",
    "commonTypeAlt": "anthroponym",
    "score": 4.758963741392455
}

Type Nom (Geo)

Type de nom à partir de nom propre , code du pays .

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.579081911201673
}

Type Nom (Geo) s'appuie sur la fonctionnalité Type Nom en incorporant le contexte local pour améliorer la précision. Elle analyse un nom propre pour déterminer s'il fait référence à une personne, un lieu géographique, un alias personnel, ou une marque.

  • Coût: 1 crédit par nom.
  • Description : Estime le type d'un ensemble de noms propres (jusqu'à 100) en se basant sur leur contexte géographique. Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
  • Plus d'informations sur : Type Nom (Geo)

Requête HTTP

requête http
POST
https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeoBatch
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

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

Corps de la requête
NomTypeRequisDescription
properNounsArray of objectsRequisUne liste de noms propres avec leur contexte géographique.
[{...}].idStringOptionelIdentifiant unique.
[{...}].nameStringRequisUn nom propre (personne, marque, etc.).
[{...}].countryIso2StringRequisContexte géographique ou pays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
properNounsArray of objectsUne liste de noms propres avec leur type estimé.
[{...}].scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
[{...}].idStringIdentifiant unique fourni.
[{...}].nameStringNom propre renseigné.
[{...}].commonTypeStringType le plus probable du nom propre.Type du nom
[{...}].commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
[{...}].scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type Geo exemple de code pour shell:

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

Paramètre du corps :

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

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}

Name Type Geo exemple de code pour java:

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

Paramètre du corps :

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

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}

Name Type Geo exemple de code pour python:

import requests

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

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

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

print(response.text)

Paramètre du corps :

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

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}

Name Type Geo exemple de code pour javascript:

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

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 :

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

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

{
    "properNouns": [
        {
            "script": "LATIN",
            "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
            "name": "Edi Gathegi",
            "commonType": "anthroponym",
            "commonTypeAlt": "brand-name",
            "score": 18.579081911201673
        }
    ]
}
  • Coût: 1 crédit par nom.
  • Description : Estime le type d'un nom propre en se basant sur son contexte géographique. Ex : Ex: John Smith = anthroponyme, Namsor = nom de marque, Cherbourg en Cotentin = toponyme, Batman = pseudonyme.
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/nameTypeGeo/{name}/{countryIso2}
En-tête de requête
PropriétéRequisDescription
X-API-KEYRequisVotre clé d'API Namsor
information

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

Paramètres de requête
NomTypeRequisDescription
nameStringRequisUn nom propre (personne, marque, etc.).
countryIso2StringRequisContexte géographique ou pays d'origine le plus probable, au format ISO 3166-1 alpha-2.
Réponse
NomTypeDescriptionÉnumérateurs
scriptStringNom de l'écriture utilisée pour le nom, au format ISO 15924.Écritures
idStringIdentifiant unique fourni.
nameStringNom propre renseigné.
commonTypeStringType le plus probable du nom propre.Type du nom
commonTypeAltStringSecond type le plus probable du nom propre.Type du nom
scoreNumberPlus élevé implique un résultat plus fiable, le score n'est pas normalisé.

Exemples d'intégration:

Name Type Geo exemple de code pour shell:

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

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.579081911201673
}

Name Type Geo exemple de code pour java:

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

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.579081911201673
}

Name Type Geo exemple de code pour python:

import requests

url = "https://v2.namsor.com/NamSorAPIv2/api2/json/nameTypeGeo/Edi%20Gathegi/KE"

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

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

print(response.text)

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.579081911201673
}

Name Type Geo exemple de code pour javascript:

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

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

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

{
    "script": "LATIN",
    "id": "e630dda5-13b3-42c5-8f1d-648aa8a21c42",
    "name": "Edi Gathegi",
    "commonType": "anthroponym",
    "commonTypeAlt": "brand-name",
    "score": 18.579081911201673
}