Geschlecht anhand E-Mail API

Anfrage im Überblick

Von der E-Mail-Adresse zur Einschätzung

GenderAPI analysiert den lokalen Teil der Adresse, extrahiert den wahrscheinlichsten Vornamen und verwendet ihn für die Geschlechtserkennung. Ergänzen Sie einen Länderkontext, wenn die Region bekannt ist.

01E-Mail-Eingabeanna.mueller@example.com

02NamensextraktionAnna

03Einschätzungfemale · 97%

MethodePOST

Content-Typeapplication/json

AuthentifizierungBearer Token

Credit-Kosten1 Anfrage

HDR

Erforderliche HTTP-Header

Anfrage autorisieren

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-Request-Body

Parameter

Parameter	Typ	Status	Beschreibung
`email`	string	Erforderlich	Zu analysierende E-Mail-Adresse. GenderAPI extrahiert vor der Einschätzung den wahrscheinlichsten Vornamen.
`country`	string	Optional	Ländercode nach ISO 3166-1 Alpha-2, zum Beispiel DE oder US, für regionalen Kontext.
`askToAI`	boolean	Optional	Bei true wird die KI-Unterstützung verwendet, wenn für den extrahierten Namen kein Datenbankergebnis vorliegt.

KI-Unterstützung

askToAI wird erst nach der Namensextraktion ausgewertet und nur dann, wenn der extrahierte Name nicht in der Datenbank gefunden wird. Der E-Mail-Endpunkt akzeptiert forceToGenderize nicht.

Codebeispiele

E-Mail-Anfrage senden

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"anna.mueller@example.com","country":"DE","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "anna.mueller@example.com", country: "DE", askToAI: true })
});
const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "anna.mueller@example.com", "country": "DE", "askToAI": True}
)
print(response.json())

200-Antwort

Extrahierter Name und Einschätzung

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "anna.mueller@example.com",
  "name": "Anna",
  "gender": "female",
  "country": "DE",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

Antwortfelder

Feld	Typ	Beschreibung
`status`	boolean	Gibt an, ob die Anfrage erfolgreich abgeschlossen wurde.
`used_credits`	integer	Durch diese Anfrage verbrauchte Credits.
`remaining_credits`	integer	Nach der Anfrage verfügbare Credits.
`expires`	integer	Ablaufzeit des Pakets als UNIX-Zeitstempel.
`q`	string	Ursprünglich übermittelte E-Mail-Adresse.
`name`	string	Aus der E-Mail-Adresse extrahierter Vorname.
`gender`	string \| null	Geschätzter Wert: male, female oder null.
`country`	string	Bei der Einschätzung berücksichtigter Ländercode.
`total_names`	integer	Anzahl der Stichproben, auf denen die Einschätzung beruht.
`probability`	integer	Wahrscheinlichkeit der Einschätzung in Prozent.
`duration`	string	Serverseitige Verarbeitungsdauer.

Eine vollständige, gültige E-Mail-Adresse verwenden

Die Namensextraktion hängt vom Aufbau der Adresse ab. Allgemeine Postfächer, Aliase oder lokale Teile ohne erkennbaren Namen liefern möglicherweise kein Ergebnis. Prüfen Sie name, gender undprobability, bevor Sie die Einschätzung verwenden. E-Mail-Anfragen werden nicht gespeichert.

Nächste Anleitung

Mehrere E-Mail-Adressen analysieren

Mehrfache E-Mail-AnfrageMehrere Adressen in einer Anfrage verarbeiten →Einzelne NamensanfrageEinen bekannten Vornamen direkt senden →