GenderAPI.io · REST API v2
Schätzen Sie das wahrscheinliche Geschlecht anhand eines Vornamens, vollständigen Namens, einer E-Mail-Adresse oder eines Benutzernamens. GenderAPI.io V2 liefert strukturiertes JSON mit der Quelle der Vorhersage, einem Konfidenzwert und optionalem Länderkontext.
GenderAPI.io V2
https://api.genderapi.io/api/v2/gender?type=name&value=OnurBeispielantwort von V2. Senden Sie eine Anfrage, um ein Live-Ergebnis zu sehen.
{
"data": {
"input": {
"type": "name",
"value": "Onur",
"country": null
},
"name": "onur",
"gender": "male",
"country": "TR",
"confidence": 0.9,
"confidence_kind": "observed_frequency",
"sample_count": 100,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "onur",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "11111111-1111-4111-8111-111111111111",
"duration_ms": 12,
"access": {
"mode": "ip_trial",
"reason": "api_key_missing"
},
"usage": {
"charged_credits": 1,
"remaining_credits": 9,
"billing_status": "confirmed",
"resets_at": "2026-09-26T12:00:00.000Z",
"limit": 10,
"period_seconds": 86400
}
}
}Analyse von Vor- und vollständigen Namen
Prüfen Sie einzelne Einträge, senden Sie Batch-Anfragen oder nutzen Sie unsere Tools für Tabellen. V2 unterscheidet Ergebnisse mit Vorhersage von Ergebnissen ohne Vorhersage, sodass Ihre Anwendung Unsicherheit erhält, statt eine Einschätzung zu erzwingen.
Geschlecht anhand des Namens
Sie erhalten eine Einschätzung mit Konfidenzwert und Quelle der Vorhersage. Wenn keine Vorhersage möglich ist, weist V2 das ausdrücklich als unbekanntes Ergebnis aus.
Geschlecht anhand der E-Mail-Adresse
Werten Sie Namenssignale in gängigen E-Mail-Formaten aus und ergänzen Sie CRM-, Lead- und Analysedaten um die Einschätzung und ihre Quelle.
Geschlecht anhand des Benutzernamens
Erkennen Sie bekannte Vornamen in Benutzernamen. Mit forceToGenderize lässt sich auch für Spitznamen ohne echten Vornamen eine Einschätzung anfordern; eine Vorhersage ist damit jedoch nicht garantiert.
Excel- und CSV-Verarbeitung
Laden Sie eine Excel- oder CSV-Datei hoch, wählen Sie die Quellspalte und laden Sie die Ergebnisse herunter. Für Batch-Anfragen aus Ihrer eigenen Anwendung nutzen Sie die Anleitung zu V2-Batch-Anfragen.
GenderAPI.io-Integrationen
Starten Sie mit der REST API oder verbinden Sie GenderAPI.io mit Tabellenkalkulationen, E-Commerce-Plattformen und Automatisierungsdiensten. Prüfen Sie in jeder Anleitung, welche API-Version die jeweilige Integration verwendet.
Häufige Fragen
Erfahren Sie mehr über Anfragearten, Konfidenz, den kostenlosen Zugang und die Kosten in Credits. Anfrageformate und Codebeispiele finden Sie in der V2-Dokumentation.
Alle häufigen Fragen ansehenGenderAPI.io schätzt das wahrscheinliche Geschlecht anhand eines Namens, einer E-Mail-Adresse oder eines Benutzernamens. V2 liefert Vorhersage, Konfidenz, Quelle und Credit-Verbrauch als JSON. Es handelt sich um Einschätzungen auf Grundlage von Namensmustern; sie bestätigen nicht die Geschlechtsidentität, die eine Person für sich angibt.
Eine Einzelanfrage prüft zuerst den Datensatz. Findet sich dort keine Vorhersage, wird standardmäßig KI verwendet. Dieser Standardmodus kostet einschließlich KI insgesamt 1 Credit. Bei Batch-Anfragen ist KI standardmäßig deaktiviert. Sie können den KI-Modus wählen oder forceToGenderize aktivieren, um Spitznamen auszuwerten.
Das Feld confidence enthält in V2 einen Wert von 0 bis 1 oder null. Das Feld confidence_kind unterscheidet die im Datensatz beobachtete Häufigkeit von einem vom Modell gemeldeten Wert; eine Garantie für die Richtigkeit des Ergebnisses ist die Konfidenz nicht. Liegt keine Vorhersage vor, enthält die Antwort gender: null und result_status: unknown.
Eine Standardanfrage in V2 kostet 1 Credit, auch wenn KI verwendet wird oder ein erfolgreich verarbeitetes Ergebnis keine Vorhersage enthält. Der KI-Modus always kostet 2 Credits. Mit forceToGenderize kostet eine Vorhersage aus dem Datensatz 1 Credit; wird KI benötigt, betragen die Kosten insgesamt 2 Credits. Bei Batch-Anfragen werden die Kosten pro Eintrag berechnet.
Ja. V2 akzeptiert bis zu 50 Einträge pro Batch mit einem gültigen API-Schlüssel oder bis zu 10 im IP-Testzugang. Eine einzige HTTP-Anfrage kann daher mehrere Credits verbrauchen. Größere Dateien können Sie auch mit den Excel- und CSV-Tools oder über weitere Integrationen verarbeiten.
Ohne API-Schlüssel nutzt die V2-Demo einen Testzugang mit 10 Credits pro 24 Stunden, die sich alle Personen mit derselben IP-Adresse teilen. Ein kostenloses Konto erhält 200 Credits pro Tag. Dabei handelt es sich um Credit-Kontingente, nicht um eine feste Anzahl von Anfragen: Modi, die 2 Credits kosten, verbrauchen das Guthaben schneller.
Ja. V1 und V2 verwenden denselben API-Schlüssel und dasselbe Kontoguthaben. Bestehende V1-Integrationen bleiben verfügbar. Neue Integrationen sollten auf der V2-Dokumentation aufbauen, da sich Endpunkte, Antwortfelder und Fehlerformat von V1 unterscheiden.
Integration starten
Erstellen Sie ein Konto, testen Sie Ihre ersten Anfragen mit 200 kostenlosen Credits pro Tag und verarbeiten Sie bei Bedarf Excel- oder CSV-Dateien.