POST AI agent ready /v1/gender/estimate

API de détection de genre – Prédire le sexe à partir du prénom

Prédit le sexe associé à un prénom à l'aide de modèles statistiques formés sur des données démographiques publiques. Renvoie « homme » ou « femme » avec un score de probabilité (0-1) et le nombre d'échantillons. Affinez éventuellement les résultats par pays pour une précision spécifique à la région.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/gender/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria","country_id":"US"}'

When to use this API

Salutations personnalisées par e-mail

Lorsque votre CRM a un prénom mais pas de champ de sexe, utilisez ce point de terminaison pour prédire le sexe et générer les salutations appropriées (« Cher M. Smith » contre « Chère Mme Johnson »). Appliquez uniquement des prédictions avec une probabilité supérieure à 0,90 pour éviter les erreurs.

Enrichissement démographique des enquêtes et analyses

Enrichissez les réponses aux enquêtes ou les analyses des utilisateurs avec le sexe prédit lorsque les informations n'ont pas été collectées directement. Utilisez les données pour créer des rapports agrégés sur la répartition par sexe au sein de votre base d'utilisateurs, les modèles d'utilisation des produits ou les résultats des tests A/B.

Recommandations de produits de commerce électronique

Prédisez le sexe à partir du prénom du titulaire du compte pour personnaliser les catégories de produits par défaut. Affichez des recommandations de vêtements, d'accessoires ou de cadeaux correspondant au sexe prédit, tout en offrant aux utilisateurs une option simple pour mettre à jour leurs préférences.

Frequently asked questions

Quelles valeurs le champ genre renvoie-t-il ?

Le champ Genre renvoie « homme » ou « femme » en fonction de la majorité statistique pour ce nom. Pour les noms avec une probabilité presque égale (par exemple « Alex »), la réponse reflète une légère majorité et la probabilité sera proche de 0,50.

Que signifie le score de probabilité ?

La probabilité est une valeur comprise entre 0 et 1 indiquant la confiance. Un score de 0,98 signifie que 98 % des personnes portant ce nom dans l'ensemble de données s'identifient au sexe prédit. Les scores inférieurs à 0,60 indiquent que le nom est fortement unisexe.

Le country_id affecte-t-il les résultats ?

Oui. Certains noms ont des associations de genre différentes selon les pays. "Andrea" est majoritairement féminine dans les pays anglophones mais masculine en Italie. Fournir un country_id donne des prévisions régionales plus précises.

Comment dois-je gérer les prédictions à faible probabilité ?

Pour les prédictions dont la probabilité est inférieure à 0,70, considérez le nom comme ambigu en termes de genre. Utilisez un langage non sexiste dans vos communications et envisagez de demander directement à l'utilisateur plutôt que de supposer.

Puis-je prédire le sexe des surnoms ou des noms abrégés ?

Oui, si le pseudo est suffisamment courant pour apparaître dans l’ensemble de données. "Mike" reviendra un homme, "Liz" reviendra une femme. Les abréviations peu courantes peuvent avoir un nombre d'échantillons inférieur et des prédictions moins fiables.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.