Déterminer le genre à partir de 50 noms d’utilisateur maximum

Aperçu de la requête en masse

Traiter jusqu'à 50 pseudos

Envoyer undatatableau. GenderAPI extrait des signaux potentiels de nom à partir de chaque handle et retourne les résultats avec votre enregistrement facultatifid.

MethodPOST

Maximum50 pseudos

Authenticationjeton Bearer

options AINon pris en charge

Les résultats massifs de pseudos nécessitent une vérification attentive.

Les handles peuvent contenir des marques, des termes fictifs ou des mots sans lien. Les demandes massives ne sont pas acceptéesaskToAI or forceToGenderize. Pour un traitement plus fiable des entrées inhabituelles, utilisez larequête unique.

HDR

En-têtes HTTP requis

Authentifier la requête en masse

Content-Typeapplication/json

AuthorizationBearer VOTRE_CLÉ_API

Corps de la requête JSON

Paramètres

Field	Type	Requirement	Description
`data`	object[]	Obligatoire	Tableau contenant entre 1 et 50 enregistrements d'identifiants d'utilisateurs.
`data[].username`	string	Obligatoire	Identifiant ou handle à analyser ; les underscores et les chiffres sont autorisés.
`data[].country`	string	Optionnel	Code alpha-2 ISO 3166-1 utilisé comme contexte régional.
`data[].id`	string \| integer	Optionnel	Votre identifiant, retourné tel quel avec le résultat correspondant.

Instructions d'entrée

Les noms d'utilisateur à caractères latins fournissent généralement des signaux de nom plus clairs. Utilisez des valeurs uniques et évaluez les données extraites avant de mettre à jour les enregistrements.idavant de mettre à jour les enregistrements.name and probabilitydemande de payload

Demande de payload

Construire l'array d'identifiant d'utilisateur

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Exemples de code

Envoyer une requête avec plusieurs identifiants d'utilisateur

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Réponse 200

Noms extrait et prédictions

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

Champs de réponse

Field	Type	Description
`status`	boolean	La demande en masse a-t-elle été exécutée avec succès ?
`used_credits`	integer	Crédits consommés pour les utilisateurs soumis.
`remaining_credits`	integer	Crédits disponibles après la demande.
`expires`	integer	Date d'expiration du forfait sous forme de timestamp UNIX.
`names`	object[]	Résultats pour les utilisateurs soumis.
`names[].name`	string	Nom potentiel extrait à partir de l'identifiant utilisateur.
`names[].q`	string	Nom d'utilisateur original soumis dans la demande.
`names[].gender`	string \| null	Valeur prédite : masculin, féminin ou null.
`names[].country`	string	Code pays considéré pour ce résultat.
`names[].total_names`	integer	Nombre d'échantillons soutenant ce résultat.
`names[].probability`	integer	Confiance de la prédiction exprimée en pourcentage.
`names[].id`	string \| integer	Identifiant d'entrée retourné pour la corrélation du enregistrement.
`duration`	string	Temps total de traitement du serveur.

Conserver chaque requête à moins de 50 enregistrements

Diviser les entrées plus grandes en lots. Un nom d'utilisateur est un signal indirect, donc vérifiez le nom extrait et établissez un seuil de probabilité acceptable avant d'appliquer les résultats.

Référence suivante

Valider et formater les numéros de téléphone

Validation du numéro de téléphoneRevoyez les méthodes de validation et de formatage →Username requête uniqueUse options AI for one handle →