Geschlecht aus einem Benutzernamen oder Nicknamen bestimmen

Anfrageübersicht

Von Benutzernamen zu wahrscheinlichem Namen

GenderAPI sucht nach Namenssignalen im eingegebenen Handle und vorhersagt das Geschlecht mithilfe von Datenbankbelegen, dem Landkontext und – bei Bedarf – eines AI-Fallbacks.

Inputsparkling_unicorn

Extracted signalSparkling

Predictionweiblich · 92%

MethodPOST

Inhaltstypapplication/json

AuthenticationBearer-Token

AI-OptionenAvailable

HDR

Erforderliche HTTP-Header

Autorisieren Sie die Anfrage

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-Anfragekörper

Parameter

Parameter	Type	Requirement	Description
`username`	string	Pflichtfeld	Benutzername, soziales Handle, Anzeigename oder Spitzname analysieren.
`country`	string	Optional	ISO 3166-1 alpha-2 Landescode, wie US oder TR, für den regionalen Kontext.
`askToAI`	boolean	Optional	Wenn true, wird bei einem extrahierten Namen ohne Datenbankergebnis ein AI-Fallback verwendet.
`forceToGenderize`	boolean	Optional	Wenn true, wird eine Vorhersage für Alias- oder Eingaben durchgeführt, die typische Namen nicht widerspiegeln.

askToAI

Verwenden Sie dies nur dann, wenn der extrahierte Name keine Ergebnisse in der Datenbank liefert.

forceToGenderize

Ermöglicht Versuche für Fantasiebegriffe, Markenähnliche Alias-Terme und ungewöhnliche Nicknames.

Vertrauen spielt eine Rolle:Zwangsläufige Ergebnisse bei schwachen oder nicht-menschlichen Namen-Signale können weniger zuverlässig sein. Beurteilenprobabilitybevor auf eine Vorhersage reagiert wird.

Codebeispiele

Ein Benutzernamen-Anfrage senden

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())

200-Antwort

Ausgelesenes Signal und Vorhersage

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"
}

Antwortfelder

Field	Type	Description
`status`	boolean	Ob die Anfrage erfolgreich abgeschlossen wurde.
`used_credits`	integer	Verbrauchte Credits für diese Anfrage.
`remaining_credits`	integer	Verfügbare Credits nach der Anfrage.
`expires`	integer	Verfallszeit des Pakets als UNIX-Timestamp.
`q`	string	Originaler Benutzername, der in der Anfrage eingereicht wurde.
`name`	string	Wahrscheinlicher Name, der aus dem Benutzernamen extrahiert wurde.
`gender`	string \| null	Vorhersagewert: männlich, weiblich oder null.
`country`	string	Landcode, der für die Vorhersage berücksichtigt wurde.
`total_names`	integer	Anzahl der Proben, die die Vorhersage unterstützen.
`probability`	integer	Vorhersagegenauigkeit in Prozent.
`duration`	string	Verarbeitungszeit des Servers.

Benutzernamen als indirekte Signale behandeln

Ein Benutzernamen kann eine Marke, eine Figur oder ein Konzept beschreiben, nicht jedoch eine Person. Bestätigen Sie, dass das extrahierte Signal sinnvoll ist und legen Sie für Ihren Anwendungsfall eine akzeptable Wahrscheinlichkeitsgrenze fest.nameist sinnvoll und legen Sie für Ihren Anwendungsfall eine akzeptable Wahrscheinlichkeitsgrenze fest.

Nächste Anleitung

Mehrere Benutzernamen analysieren

Mehrere Benutzernamen in einer Anfrage verarbeitenMehrere Handles in einer Anfrage verarbeiten →E-Mail-EinzelanfrageEin Name aus einer E-Mail extrahieren →