Zum Inhalt springen
POST AI agent ready /v1/gender/estimate

Geschlechtserkennungs-API – Geschlecht anhand des Vornamens vorhersagen

Prognostiziert das mit einem Vornamen verbundene Geschlecht mithilfe statistischer Modelle, die auf öffentlichen demografischen Daten trainiert wurden. Gibt „männlich“ oder „weiblich“ mit einem Wahrscheinlichkeitswert (0-1) und der Stichprobenanzahl zurück. Optional können Sie die Ergebnisse nach Ländern eingrenzen, um eine regionsspezifische Genauigkeit zu erzielen.

Parameters

stringrequired

First name to predict gender for.

string

ISO 3166-1 alpha-2 country code for country-specific prediction.

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

Personalisierte E-Mail-Anreden

Wenn Ihr CRM über einen Vornamen, aber kein Geschlechtsfeld verfügt, verwenden Sie diesen Endpunkt, um das Geschlecht vorherzusagen und entsprechende Anreden zu generieren („Sehr geehrter Herr Smith“ vs. „Sehr geehrte Frau Johnson“). Wenden Sie nur Vorhersagen mit einer Wahrscheinlichkeit über 0,90 an, um Fehler zu vermeiden.

Demografische Bereicherung durch Umfragen und Analysen

Reichern Sie Umfrageantworten oder Benutzeranalysen mit dem vorhergesagten Geschlecht an, wenn die Informationen nicht direkt erfasst wurden. Verwenden Sie die Daten für aggregierte Berichte zur Geschlechterverteilung innerhalb Ihrer Benutzerbasis, zu Produktnutzungsmustern oder zu A/B-Testergebnissen.

Produktempfehlungen für den E-Commerce

Sagen Sie das Geschlecht anhand des Vornamens des Kontoinhabers voraus, um Standardproduktkategorien zu personalisieren. Zeigen Sie Kleidungs-, Accessoires- oder Geschenkempfehlungen an, die auf das vorhergesagte Geschlecht abgestimmt sind, und bieten Sie Benutzern gleichzeitig eine einfache Möglichkeit, ihre Vorlieben zu aktualisieren.

Frequently asked questions

Welche Werte gibt das Feld „Geschlecht“ zurück?
Das Feld „Geschlecht“ gibt „männlich“ oder „weiblich“ zurück, basierend auf der statistischen Mehrheit für diesen Namen. Bei Namen mit nahezu gleicher Wahrscheinlichkeit (z. B. „Alex“) spiegelt die Antwort die knappe Mehrheit wider und die Wahrscheinlichkeit liegt nahe bei 0,50.
Was bedeutet der Wahrscheinlichkeitswert?
Die Wahrscheinlichkeit ist ein Wert zwischen 0 und 1, der Vertrauen anzeigt. Ein Wert von 0,98 bedeutet, dass sich 98 % der Personen mit diesem Namen im Datensatz mit dem vorhergesagten Geschlecht identifizieren. Werte unter 0,60 weisen darauf hin, dass der Name stark geschlechtsspezifisch ist.
Beeinflusst die Länder-ID die Ergebnisse?
Ja. Einige Namen haben in verschiedenen Ländern unterschiedliche Geschlechterassoziationen. „Andrea“ ist in englischsprachigen Ländern überwiegend weiblich, in Italien jedoch männlich. Durch die Angabe einer „country_id“ erhalten Sie genauere regionale Vorhersagen.
Wie soll ich mit Vorhersagen mit geringer Wahrscheinlichkeit umgehen?
Behandeln Sie den Namen bei Vorhersagen mit einer Wahrscheinlichkeit unter 0,70 als geschlechtsspezifisch. Verwenden Sie in der Kommunikation eine geschlechtsneutrale Sprache und erwägen Sie, den Benutzer direkt zu fragen, anstatt ihn anzunehmen.
Kann ich das Geschlecht von Spitznamen oder Kurznamen vorhersagen?
Ja, wenn der Spitzname häufig genug vorkommt, um im Datensatz angezeigt zu werden. „Mike“ wird als Mann zurückkehren, „Liz“ als Frau. Ungewöhnliche Abkürzungen können zu geringeren Stichprobenzahlen und weniger zuverlässigen Vorhersagen führen.

Get your API key

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

Sign up free View full docs