# Dokumentation zu GenderAPI.io V2

> Verbinden Sie Ihre Anwendung über api.genderapi.io mit GenderAPI.io V2. Erstellen Sie Vorhersagen aus Namen, E-Mail-Adressen oder Benutzernamen, verarbeiten Sie gemischte Batches und lesen Sie die Ergebnisse zusammen mit den Metadaten zu Zugang und Abrechnung.

Canonical HTML: https://www.genderapi.io/de/api-documentation

Last reviewed: 2026-09-28

## Erste Anfrage senden

Nutzen Sie GenderAPI.io V2, um das Geschlecht anhand eines Vornamens oder vollständigen Namens, einer E-Mail-Adresse oder eines Benutzernamens zu schätzen. Der Ursprung der API ist https://api.genderapi.io, der Basispfad von V2 lautet /api/v2. Testen Sie das GET-Beispiel unten in Ihrem Browser und wählen Sie dann eine Anleitung, um Ihre Anwendung anzubinden.

Der kostenlose IP-Testzugang umfasst 10 Credits pro IP-Adresse innerhalb von 24 Stunden, gemeinsam mit V1. Dieses Beispiel nutzt nur den Datensatz und kostet 1 Credit pro Anfrage, auch bei jedem Neuladen. Wenn Sie Ihren vorhandenen API-Schlüssel verwenden, nutzen V1 und V2 dasselbe Kontoguthaben.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Lena&country=DE&ai_mode=off
```

- [GET-Beispiel öffnen (verbraucht 1 Credit aus dem Testzugang)](https://api.genderapi.io/api/v2/gender?type=name&value=Lena&country=DE&ai_mode=off)
- [Richten Sie Ihren API-Schlüssel ein](https://www.genderapi.io/de/docs/v2/authentication#environment-setup)
- [JSON-Antwort verstehen](https://www.genderapi.io/de/docs/v2/responses)

## Was möchten Sie tun?

Wählen Sie Ihren Eingabetyp für lauffähige Beispiele in cURL, JavaScript, Python, PHP, Java, C# und Go. Nutzen Sie die Anleitungen zu Ergebnissen und Abrechnung, sobald Sie echte Antworten verarbeiten möchten.

- [API-Schlüssel & Testzugang](https://www.genderapi.io/de/docs/v2/authentication): Verbinden Sie Ihren API-Schlüssel oder testen Sie die API kostenlos.
- [Anfrageparameter](https://www.genderapi.io/de/docs/v2/request-parameters): Wählen Sie Eingabefelder, Länderkontext und Anfrageoptionen.
- [Offizielle SDKs](https://www.genderapi.io/de/docs/v2/sdks): Installieren Sie einen offiziellen Client für Ihre Programmiersprache.
- [Geschlecht aus Namen](https://www.genderapi.io/de/docs/v2/gender-from-name): Fragen Sie einen Vornamen oder vollständigen Namen ab.
- [Geschlecht aus E-Mail-Adressen](https://www.genderapi.io/de/docs/v2/gender-from-email): Finden Sie einen Namenshinweis in einer E-Mail-Adresse.
- [Geschlecht aus Benutzernamen](https://www.genderapi.io/de/docs/v2/gender-from-username): Verwenden Sie einen Benutzernamen oder Spitznamen als Eingabe.
- [Batch-Abfragen](https://www.genderapi.io/de/docs/v2/batch): Verarbeiten Sie bis zu 50 Namen, E-Mail-Adressen oder Benutzernamen auf einmal.
- [Telefonvalidierung](https://www.genderapi.io/de/docs/v2/phone-validation): Prüfen und formatieren Sie eine Telefonnummer.
- [Antworten lesen](https://www.genderapi.io/de/docs/v2/responses): Lesen Sie Vorhersagen, Konfidenzwerte und unbekannte Ergebnisse.
- [KI & Spitznamen](https://www.genderapi.io/de/docs/v2/ai-options): Legen Sie fest, wann KI eingesetzt wird und wie Spitznamen ausgewertet werden.
- [Credits & Guthaben](https://www.genderapi.io/de/docs/v2/credits-and-usage): Prüfen Sie Ihr Guthaben und die Kosten jeder Anfrage.
- [Fehler & Wiederholungen](https://www.genderapi.io/de/docs/v2/errors-and-retries): Beheben Sie Fehler und entscheiden Sie, wann eine Wiederholung sinnvoll ist.
- [Von V1 auf V2 umsteigen](https://www.genderapi.io/de/docs/v2/migration): Aktualisieren Sie eine bestehende Integration mit demselben API-Schlüssel.

## Endpunkt-Referenz

Kombinieren Sie https://api.genderapi.io mit den absoluten Pfaden in dieser Tabelle, zum Beispiel: https://api.genderapi.io/api/v2/gender. Query-Parameter werden nur bei GET /gender unterstützt. Verwenden Sie für POST-Routen einen JSON-Body; senden Sie in einer V2-Anfrage keine V1-Felder wie name, email, username oder askToAI.

| Methode | Pfad | Zweck |
| --- | --- | --- |
| GET | /api/v2 | Öffentliche Funktionen und aktuelle Limits; kostenlos. |
| GET | /api/v2/openapi.json | Kanonischer OpenAPI-Vertrag; kostenlos. |
| GET | /api/v2/errors | Maschinenlesbarer Fehlerkatalog; kostenlos. |
| GET | /api/v2/usage | Aktuelles Guthaben des Kontos oder des Testzugangs; kostenlos. |
| GET / POST | /api/v2/gender | Ein Name, eine E-Mail-Adresse oder ein Benutzername. |
| POST | /api/v2/gender/batch | Ein geordneter Batch aus Namen, E-Mail-Adressen und/oder Benutzernamen. |
| POST | /api/v2/phone/validate | Eine Telefonnummer validieren und formatieren. |