# GenderAPI.io V2 mit Zapier verbinden

> Verbinden Sie Zapier mit GenderAPI.io V2 für Einträge in Mailchimp. Wählen Sie den passenden Konnektor, senden Sie type und value und verarbeiten Sie anschließend data, meta, Credits und Fehler.

Canonical HTML: https://www.genderapi.io/de/blog/zapier-gender-api-integration

Last reviewed: 2026-09-28

## Wählen Sie die Zapier-Verbindung, die zu Ihrem API-Vertrag passt

Das HTTP-Rezept in dieser Anleitung ruft GenderAPI.io V2 unter https://api.genderapi.io/api/v2/gender auf. Senden Sie type und value im JSON-Body; die Vorhersage lesen Sie aus data, die Angaben zur Anfrage und zur Abrechnung aus meta. Integrierte Konnektoren haben eigene Verträge, die unten beschrieben sind.

Zapier bietet GenderAPI.io-Aktionen zur Bestimmung des Geschlechts anhand eines Namens oder einer E-Mail-Adresse. Die öffentliche Seite nennt weder die Version des Endpunkts noch den V2-Antwortvertrag. Bevor Sie Zuordnungen in nachfolgenden Schritten ändern, prüfen Sie die Ausgabe bestehender nativer Aktionen.

Die folgende V2-Einrichtung verwendet Webhooks by Zapier mit einer strukturierten POST-Anfrage. Webhooks by Zapier erfordert einen kostenpflichtigen Zapier-Tarif. Das Guthaben des GenderAPI-Kontos und die in Zapier verbrauchten Aufgaben werden getrennt abgerechnet.

- [GenderAPI.io-App bei Zapier](https://zapier.com/apps/gender-api/integrations)
- [Bestehende V1-Dokumentation](https://www.genderapi.io/de/api-documentation/v1)

## Konto und Quelleintrag vorbereiten

Dieses Beispiel reichert Einträge in Mailchimp anhand der E-Mail-Adresse an. Sie benötigen Zugriff auf die Quell- und die Zielanwendung, einen GenderAPI.io-Kontoschlüssel und die Plattformfunktionen, die die HTTP-Aktion verwendet. Diese Anleitung enthält keine funktionierenden Zugangsdaten und keine verbundenen Konten.

V1 und V2 verwenden denselben Kontoschlüssel und dasselbe Guthaben. Bevor Sie eine kostenpflichtige Anfrage einrichten, prüfen Sie den Schlüssel mit GET /api/v2/usage und stellen Sie sicher, dass meta.access.mode in der Antwort dieses Endpunkts den Wert api_key hat. Ein fehlender oder nicht erkannter Schlüssel kann dazu führen, dass der gemeinsame IP-Testzugang verwendet wird; eine produktive Automatisierung sollte diesen nicht unbemerkt nutzen.

Lassen Sie den Workflow während der Einrichtung deaktiviert. Eine Testvorhersage verbraucht gewöhnliche Credits. Diese Anleitungen wurden anhand der öffentlichen Dokumentation und des V2-Vertrags geprüft; für diese Veröffentlichung wurde auf keiner Plattform ein authentifizierter Workflow vollständig von Anfang bis Ende ausgeführt.

- [Authentifizierung und kostenlose Nutzungsprüfung](https://www.genderapi.io/de/docs/v2/authentication#environment-setup)

## Die GenderAPI.io-V2-Anfrage in Zapier konfigurieren

- Beginnen Sie mit einem Mailchimp-Trigger, der den richtigen Abonnenteneintrag liefert. Bewahren Sie die IDs der Zielgruppe (Audience) und des Kontakts auf und fügen Sie vor der HTTP-Aktion einen Filter hinzu, der leere E-Mail-Adressen überspringt.
- Wählen Sie Webhooks by Zapier und die Aktion POST. Geben Sie die folgende URL und Payload Type: JSON an. Fügen Sie die Datenfelder type = email, value = zugeordnete E-Mail-Adresse des Abonnenten und options__ai_mode = off hinzu.
- Die Schreibweise mit doppeltem Unterstrich verschachtelt options__ai_mode in Zapier als options.ai_mode im JSON-Body. Der folgende Codeblock zeigt den Body, den die API erhält; er ist kein viertes Feld, das Sie in die Aktion einfügen.
- Fügen Sie im Bereich Headers Authorization mit dem Wert Bearer YOUR_API_KEY hinzu. Verwenden Sie application/json als Content-Type. Schreiben Sie den Schlüssel nicht in Trigger-Felder, in die Abfragezeichenfolge oder in Beispielantworten.

| HTTP-Einstellung | Wert | Zweck |
| --- | --- | --- |
| `Method` | `POST` | Sendet eine einzelne Vorhersageanfrage. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | V2-Endpunkt von GenderAPI.io für einzelne Vorhersagen. |
| `Authorization` | `Bearer YOUR_API_KEY` | Ersetzen Sie den Platzhalter über die Authentifizierungs- oder Header-Einstellungen der Plattform. |
| `Content-Type` | `application/json` | Sendet ein Objekt mit verschachteltem options-Objekt, keine Formularfelder. |
| `options.ai_mode` | `off` | Erster bewusster Test nur mit dem Datensatz: normale Abbuchung von 1 Credit, auch wenn das Ergebnis unknown ist. |

## JSON-Body vor dem Senden prüfen

Dieses Beispiel zeigt eine feste Eingabe; es ist kein vorhergesagtes Ergebnis. Prüfen Sie zuerst die Struktur der Anfrage und ersetzen Sie dann value durch das zugeordnete Quellfeld, mit korrekter JSON-Serialisierung. Senden Sie Zuordnungsausdrücke der Plattform nicht als wörtlichen Text an die API.

Setzen Sie für andere Eingaben type auf name, email oder username und geben Sie den passenden Wert in value an. Fügen Sie country nur hinzu, wenn Sie verlässlichen Kontext haben: Das Feld ist optional und dient nicht dazu, das Wohnsitzland zu bestimmen.

**V2-JSON-Anfrage für Zapier**

```json
{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}
```

- [Anfragefelder, Typen und Standardwerte](https://www.genderapi.io/de/docs/v2/request-parameters)

## Den HTTP-Schritt prüfen, bevor Sie Aktualisierungen aktivieren

Webhook-Header sind kein eigenes Feld für Geheimnisse: Wer den Zap bearbeiten kann, sieht sie. Beschränken Sie den Zugriff und teilen Sie weder den Zap noch Bildschirmfotos oder Exporte, die Zugangsdaten enthalten. Zapier bietet auch API by Zapier mit gespeicherten Zugangsdaten an, doch die Konfiguration des Anfrage-Bodys unterscheidet sich dort von diesem strukturierten POST-Rezept.

Umhüllen Sie den Body nicht: Senden Sie ein einzelnes Objekt, keine Liste und kein Array. Wählen Sie für zugeordnete Kundendaten die strukturierte JSON-Aktion; Custom Request sendet Rohtext und maskiert Sonderzeichen in eingefügten Werten nicht automatisch.

- [Strukturierte Webhook-Anfragen und verschachteltes JSON in Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Verbindungen mit Zugangsdaten in API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Verhalten der Wiederholung (Replay) in Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)

## Ergebnisse identified, unknown und Fehler getrennt behandeln

Werten Sie den Antwort-Body aus, bevor Sie eine Zielaktualisierung auswählen. Die folgenden JSON-Pfade beziehen sich auf den V2-Antwort-Body; Ihre Plattform kann ihn umhüllen oder abflachen. Bestätigen Sie die tatsächlich zurückgegebene Struktur in einem gezielten Test und speichern Sie das Ergebnis zusammen mit der ID des Quelleintrags.

Eine Vorhersage bestimmt weder die Identität einer Person noch das Geschlecht, das diese Person selbst angibt. Bewahren Sie sie getrennt von Angaben der Person selbst auf. Legen Sie Akzeptanzkriterien anhand repräsentativer Daten aus Ihrem eigenen Anwendungsfall fest und bewerten Sie die Konfidenz aus dem Datensatz und die KI-Konfidenz getrennt.

| Prüfung | Erwarteter Wert oder Typ | Entscheidung im Workflow |
| --- | --- | --- |
| `meta.access.mode` | api_key für diesen Konto-Workflow | Halten Sie den Workflow an, wenn der Wert ip_trial ist, und korrigieren Sie den Schlüssel. Eine erfolgreiche Antwort im Testzugang belegt keine Kontoauthentifizierung und kann bereits Test-Credits verbraucht haben. |
| `meta.usage.billing_status` | confirmed oder unconfirmed | Ist der Wert unconfirmed, bewahren Sie die Anfrage-ID auf und klären Sie die Abrechnung, bevor Sie es erneut versuchen oder fortfahren. |
| `data.result_status / data.gender` | identified mit male oder female; unknown mit null | Speichern Sie akzeptierte Ergebnisse identified in einem eigenen Feld für abgeleitete Angaben. Behalten Sie Ergebnisse unknown bei, ohne eine Standardkategorie zuzuweisen. |
| `data.confidence / data.confidence_kind` | Zahl von 0–1 oder null; Art des Belegs oder null | Interpretieren Sie observed_frequency und model_reported getrennt; keiner der beiden Werte garantiert eine allgemeine Genauigkeit. |
| `data.source / data.sample_count` | dataset, ai oder none / Ganzzahl oder null | Bewahren Sie die Herkunft der Vorhersage auf. KI hat keine gespeicherte Stichprobengröße; eine Stichprobengröße aus dem Datensatz ist kein Maß für die Genauigkeit des Produkts. |
| `meta.request_id / meta.usage` | Referenz der Anfrage / Nutzungsobjekt | Speichern Sie beides zusammen mit dem Workflow-Eintrag und dem Ergebnis. Schreiben Sie keine API-Schlüssel oder unnötigen personenbezogenen Daten in routinemäßige Logs. |
| `HTTP-Fehler / keine Antwort` | Problem Details oder keine vollständige Antwort | Halten Sie die Aktualisierung an und prüfen Sie den Fehler sowie den Abrechnungsstatus. Eine Zeitüberschreitung belegt nicht, dass der Server nichts verarbeitet hat. |

- [Vollständige Dokumentation der V2-Antwort](https://www.genderapi.io/de/docs/v2/responses)
- [Fehler und Entscheidungen über Wiederholungen](https://www.genderapi.io/de/docs/v2/errors-and-retries)

## Nur den passenden Eintrag in Mailchimp aktualisieren

Prüfen Sie die ausgewertete Antwort der Testaktion und wählen Sie die Felder für data.gender, data.result_status und die übrigen oben genannten V2-Pfade. Die Feldauswahl von Zapier kann verschachtelte Bezeichnungen abflachen: Orientieren Sie sich am beobachteten Wert und am übergeordneten Pfad, statt das ältere Feld probability des nativen Konnektors vorauszusetzen. Aktualisieren Sie nur den Mailchimp-Abonnenten, dessen ID bewahrt wurde.

Testen Sie die Zweige für ein Ergebnis identified, ein Ergebnis unknown und einen Fehler, bevor Sie Aktualisierungen aktivieren. Mit fiktiven Beispielantworten lassen sich die Verzweigungsbedingungen prüfen, ohne eine neue Vorhersage zu senden. Die Aktualisierung in der Zielanwendung sollte von den obigen Prüfungen abhängen und darf keine unabhängigen Felder oder Tags überschreiben.

- [Antwortfelder und unbekannte Ergebnisse](https://www.genderapi.io/de/docs/v2/responses)
- [Genauigkeit und Konfidenz erklärt](https://www.genderapi.io/de/accuracy-methodology)
- [Datenquellen und das datierte Datenbankprofil](https://www.genderapi.io/de/data-provenance)

## Wiederholungen und erneute Abbuchungen kontrollieren

Prüfen Sie vor dem Aktivieren des Zaps die Einstellungen für Autoreplay und die manuelle Wiederholung (Replay) in Zapier. Die Wiederholung einer fehlgeschlagenen Webhook-Aktion sendet eine neue Anfrage; wiederholen Sie eine erfolgreiche Anfrage nicht, nur um einen späteren Mailchimp-Schritt zu reparieren. Speichern Sie die ursprünglichen Abonnenten-IDs und das Ergebnis der Anfrage zusammen.

Jede neue Anfrage an GenderAPI ist ein eigenständiger Vorgang. Deduplizieren Sie wiederholte Quellereignisse vor dem Senden in Ihrem eigenen Workflow, anhand der gespeicherten Quell-ID und des Verarbeitungsstatus. Die ID des Quelleintrags ist kein Schlüssel, der serverseitig vor Wiederholungen schützt.

Ein erfolgreiches Ergebnis unknown ist ein vollständiges, kostenpflichtiges Ergebnis. Bei einer Zeitüberschreitung oder einer unvollständigen Antwort können Ergebnis und Abbuchung unbekannt sein: Bewahren Sie die Anfragereferenz auf, sofern vorhanden, und klären Sie die Abrechnung, bevor Sie die Anfrage erneut senden. Beachten Sie den Header Retry-After, wenn er eine Antwort zur Überschreitung des Anfragelimits begleitet.

- [Credits und Abrechnungsstatus](https://www.genderapi.io/de/docs/v2/credits-and-usage)

## Festlegen, wann KI eingesetzt wird

forceToGenderize ist für Namen, E-Mail-Adressen und Benutzernamen optional. Ist es aktiviert, lassen Sie ai_mode weg oder verwenden Sie fallback; off und always sind damit unvereinbar und liefern 422. Ein positives Anfangsguthaben genügt, um eine Anfrage zu starten, auch wenn die endgültige Abbuchung das Guthaben unter null senkt.

Der Spitznamenmodus kann ein Geschlecht zusammen mit name: null zurückgeben. Er kann auch ein unbekanntes Ergebnis liefern. Weder der gewöhnliche KI-Fallback noch die Spitznamen-Auswertung garantieren eine richtige Antwort oder einen Wert ungleich null.

| Anfrageoption | Verhalten | Credits für eine erfolgreiche Abfrage |
| --- | --- | --- |
| options.ai_mode: off | Nur den Datensatz verwenden. | 1, auch bei einem unbekannten Ergebnis |
| options.ai_mode: fallback | Zuerst den Datensatz prüfen, dann gewöhnliche KI, wenn kein Geschlecht zurückgegeben wird. Das ist der Standard für Einzelanfragen. | Insgesamt 1, einschließlich KI-Fallback |
| options.ai_mode: always | Direkt KI verwenden. | 2 |
| forceToGenderize: true | Zuerst den Datensatz prüfen, dann KI einen persönlichen Spitznamen oder Alias auswerten lassen, auch ohne echten Vornamen. | 1 für ein im Datensatz aufgelöstes Ergebnis; insgesamt 2, wenn KI eingesetzt wird |

- [KI-Optionen und Spitznamen-Auswertung](https://www.genderapi.io/de/docs/v2/ai-options)
- [Credits und Nutzung](https://www.genderapi.io/de/docs/v2/credits-and-usage)

## Workflow prüfen, bevor Sie das Volumen erhöhen

- Prüfen Sie in einem gezielten Test das tatsächlich serialisierte JSON, die ausgewerteten Ergebnispfade, den Zugang per API-Schlüssel und die Bestätigung der Abrechnung. Testen Sie, wo möglich, die Behandlung von Ergebnissen unknown und von Fehlern mit Beispielantworten.
- Klären Sie, welche Workflow-Schritte wiederholt werden und welche Kundenfelder sich ändern. Bewahren Sie die ID des Quelleintrags, die erhaltene Antwort und die Referenz der Anfrage auf, damit ein späterer Fehler im Zielsystem keine weitere Anfrage erfordert.
- Aktivieren Sie zuerst einen kleinen, kontrollierten Lauf und prüfen Sie dessen Einträge und Credits, bevor Sie die Parallelität erhöhen. GenderAPI-Credits und die von der Automatisierungsplattform abgerechneten Aufgaben oder Operationen sind getrennte Kosten.
- Verwenden Sie für Batches POST /api/v2/gender/batch mit bis zu 50 Einträgen beim Zugang per API-Schlüssel oder 10 im IP-Testzugang. Das Array items kann Namen, E-Mail-Adressen und Benutzernamen kombinieren, mit ausdrücklichen Optionen und einer eindeutigen id für jeden Eintrag. Prüfen Sie jedes Ergebnis: Eine Antwort mit HTTP 200 kann Teilfehler enthalten. Die Batch-Unterstützung eines nativen Konnektors muss gesondert geprüft werden.

- [Batches und Teilfehler](https://www.genderapi.io/de/docs/v2/batch)
- [Implementierungsleitfaden für Python](https://www.genderapi.io/de/integrations/python)
- [Implementierungsleitfaden für Node.js](https://www.genderapi.io/de/integrations/javascript)

## Warum verwendet die Zapier-Einrichtung options__ai_mode?

Die strukturierte POST-Aktion in Webhooks verwendet einen doppelten Unterstrich, um verschachteltes JSON zu erzeugen. Die API erhält options: {ai_mode: off}, wobei off eine Zeichenkette ist. Sie erhält kein wörtliches Feld options__ai_mode auf oberster Ebene.

## Erlaubt das direkte HTTP-Beispiel den Einsatz von KI?

Der Body der ersten Anfrage setzt options.ai_mode auf off. Ändern Sie diesen Wert bewusst auf fallback, um den gewöhnlichen KI-Fallback für insgesamt 1 Credit zu nutzen, oder auf always, um direkt KI für 2 Credits zu verwenden. forceToGenderize prüft zuerst den Datensatz: Es kostet 1 Credit, wenn die Anfrage dort aufgelöst wird, oder insgesamt 2, wenn KI eingesetzt wird.

## Ist ein Ergebnis unknown kostenlos und kann es gefahrlos automatisch wiederholt werden?

Nein. Ein erfolgreiches Ergebnis unknown ist vollständig und kostenpflichtig. Eine Wiederholung ist eine neue Abfrage. Prüfen Sie bei einem Transportfehler oder einer unbestätigten Abrechnung die zurückgegebenen Nutzungsdaten und die Referenz der Anfrage, bevor Sie entscheiden, die Anfrage erneut zu senden.

## Wurde dieser Workflow mit einem verbundenen Konto ausgeführt?

Nein. Die Einrichtungsanleitungen der Plattformen wurden am 26. September 2026 anhand ihrer öffentlichen Dokumentation geprüft. Die Erläuterungen zu Anfrage und Antwort von GenderAPI.io V2 wurden am 27. September 2026 geprüft. Die Überarbeitung dieser deutschen Fassung vom 28. September 2026 ist eine Prüfung der Übersetzung und kein neuer Test mit einem Konto. Bevor Sie produktive Aktualisierungen aktivieren, testen Sie mit Ihrem eigenen Konto die aktuellen Felder der gewählten Aktion, die Authentifizierung, den Anfrage-Body, die Antwort und die Wiederholungen.

## Quellendokumentation

- [GenderAPI.io-App bei Zapier](https://zapier.com/apps/gender-api/integrations)
- [Strukturierte Webhook-Anfragen und verschachteltes JSON in Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [Verbindungen mit Zugangsdaten in API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [Verhalten der Wiederholung (Replay) in Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)
- [Anfragevertrag von GenderAPI.io V2](https://www.genderapi.io/de/docs/v2/request-parameters)
- [Antwortvertrag von GenderAPI.io V2](https://www.genderapi.io/de/docs/v2/responses)
- [Abrechnung und Credits von GenderAPI.io V2](https://www.genderapi.io/de/docs/v2/credits-and-usage)