Déterminer le genre à partir de jusqu'à 50 adresses e-mail

Aperçu de la demande en masse

Traiter jusqu'à 50 adresses e-mail

Envoyer undatatableau. GenderAPI extrait un nom probable à partir de chaque adresse et retourne la prédiction correspondante ; votre optionnelidpermet une corrélation de base de données déterministe.

MethodPOST

Maximum50 emails

Authenticationjeton Bearer

Format de résultatnames[]

50 emails maximumExtraction de nomRésultats conscients du pays

HDR

En-têtes HTTP requises

Authentifier la demande en masse

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corps de la requête JSON

Paramètres

Field	Type	Requirement	Description
`data`	object[]	Requis	Tableau contenant entre 1 et 50 enregistrements d'e-mail.
`data[].email`	string	Requis	Adresse e-mail à partir de laquelle GenderAPI extrait un prénom probable.
`data[].country`	string	Optionnel	Code alpha-2 ISO 3166-1 utilisé comme contexte régional.
`data[].id`	string \| integer	Optionnel	Votre identifiant d'enregistrement, retourné tel quel avec le résultat correspondant.

Correspondance d'enregistrement

Utiliser une valeur uniqueidPour chaque élément. GenderAPI le retourne associé au résultat de cet élément, permettant de mettre à jour le bon enregistrement de la base de données sans se fier uniquement à la position dans un tableau.

Charge du requête

Construire le tableau des emails

JSON

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

Exemples de code

Envoyer une requête multiple emails

cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Réponse 200

Noms extraits et prédictions

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Champs de réponse

Field	Type	Description
`status`	boolean	Indique si la requête en masse s'est terminée avec succès.
`used_credits`	integer	Crédits consommés pour toutes les emails soumis.
`remaining_credits`	integer	Crédits disponibles après la requête.
`expires`	integer	Date d'expiration du forfait sous forme de timestamp UNIX.
`names`	object[]	Collection ordonnée des résultats pour les emails soumis.
`names[].name`	string	Prénom extrait de l'adresse email.
`names[].q`	string	Email original soumis dans la requête.
`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'examplaires 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 dossier.
`duration`	string	Temps total de traitement du serveur.

Conserver chaque demande à moins de 50 enregistrements

Valider chaque adresse et diviser les ensembles de données plus grands en lots de 50 au maximum. Vérifier l'extractionname and probabilityavant d'appliquer un résultat.

Prochaine étape

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

Demande unique pour un nom d'utilisateurExtraire un prénom à partir d'un nom d'utilisateur →Demande unique pour un emailUtiliser un recours à l'IA pour un e-mail →