Déterminer le sexe à partir d'un nom d'utilisateur ou d'un surnom

Aperçu de la demande

Passer d'un nom d'utilisateur à un nom probable

GenderAPI recherche des signaux de nom dans le handle soumis, puis prédit le sexe en utilisant des preuves de base de données, le contexte national et—lorsqu'il est demandé—un recours à l'IA.

Inputsparkling_unicorn

Signal extraitSparkling

Predictionfemme · 92%

MethodPOST

Type de contenuapplication/json

AuthenticationToken Bearer

Options AIAvailable

HDR

En-têtes HTTP requis

Authentifier la requête

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corps de requête JSON

Paramètres

Parameter	Type	Requirement	Description
`username`	string	Obligatoire	Nom d'utilisateur, identifiant social, nom affiché ou surnom à analyser.
`country`	string	Facultatif	Code pays ISO 3166-1 alpha-2, tel que US ou TR, pour un contexte régional.
`askToAI`	boolean	Facultatif	Lorsque vrai, utiliser un recours à l'IA si le nom extrait n'a pas de résultat dans la base de données.
`forceToGenderize`	boolean	Facultatif	Lorsque vrai, tenter une prédiction pour des alias ou des entrées qui ne ressemblent pas à des noms typiques.

askToAI

Utiliser uniquement lorsque le nom extrait n'a pas de résultat dans la base de données.

forceToGenderize

Permet des tentatives pour des termes fictifs, des alias similaires à des marques et des surnoms inhabituels.

La confiance compte :Les résultats imposés pour des signaux de nom faibles ou non humains peuvent être moins fiables. Évaluerprobabilityavant d'agir sur une prédiction.

Exemples de code

Envoyer une requête de nom d'utilisateur

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

Réponse 200

Signal extrait and prediction

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

Champs de réponse

Field	Type	Description
`status`	boolean	Indique si la requête a été effectuée avec succès.
`used_credits`	integer	Crédits consommés par cette requête.
`remaining_credits`	integer	Crédits disponibles après la requête.
`expires`	integer	Date d'expiration du package sous forme de timestamp UNIX.
`q`	string	Pseudo-utilisateur soumis dans la requête.
`name`	string	Nom probable extrait du pseudo-utilisateur.
`gender`	string \| null	Valeur prédite : homme, femme ou null.
`country`	string	Code pays considéré pour la prédiction.
`total_names`	integer	Nombre d'échantillons soutenant la prédiction.
`probability`	integer	Confiance de la prédiction exprimée en pourcentage.
`duration`	string	Temps de traitement du serveur.

Traiter les noms d'utilisateur comme des signaux indirects

Un nom d'utilisateur peut décrire une marque, un personnage ou un concept plutôt qu'une personne. Vérifier que l'extrait est significatif et établir un seuil de probabilité acceptable pour votre cas d'usage. Vérifiez que la valeur name extraite est pertinente et définissez un seuil de probabilité acceptable pour votre cas d’usage.

Prochaine guide

Analyser plusieurs noms d'utilisateurs

Demande multiple sur un nom d'utilisateurTraiter plusieurs identifiants dans une seule demande →Demande unique par e-mailExtraire un nom à partir d'une adresse e-mail →