# Datenquellen und Bestandsaufnahme von GenderAPI.io V2

> Lernen Sie die Quellen der V2-Antworten, die datierte Bestandsaufnahme der Datenbank, Konsistenzprüfungen an Stichproben und die Grenzen der veröffentlichten Quellendokumentation kennen.

Canonical HTML: https://www.genderapi.io/de/data-provenance

Last reviewed: 2026-09-28

## Was bedeutet source in V2?

Das Feld source zeigt den Weg, der das endgültige Ergebnis geliefert hat: die Suche im gespeicherten Datensatz, eine KI-Inferenz oder keine ausgewählte Quelle. Es ist weder ein Verweis auf den ursprünglichen Herausgeber eines Datensatzes noch ein Lizenznachweis noch eine Garantie, dass die Inferenz richtig ist.

Diese Anleitung beschreibt den aktuellen V2-Antwortvertrag und ein von GenderAPI.io erstelltes Datenbankprofil. Die folgenden Beobachtungen sind Bestandsmessungen und Konsistenzprüfungen; ein geprüfter Katalog der ursprünglichen Quellen und eine unabhängige Genauigkeitsbewertung wurden noch nicht veröffentlicht.

| source | Bedeutung | Was es nicht belegt |
| --- | --- | --- |
| `dataset` | Ein gespeicherter Eintrag wurde ausgewählt; bei exakt gleichen Häufigkeiten kann das Geschlecht trotzdem unbekannt sein | Ursprünglichen Herausgeber, Erhebungsmethode, Lizenz, Alter des Eintrags oder Unabhängigkeit der Beobachtungen |
| `ai` | Die endgültige Antwort stammt aus dem konfigurierten KI-Inferenzweg; gender kann trotzdem null sein | Eine gezählte Stichprobe, einen Verweis auf den Datensatz oder eine kalibrierte Vorhersagegenauigkeit |
| `none` | Im Modus nur mit dem Datensatz wurde für das endgültige Ergebnis kein gespeicherter Eintrag ausgewählt | Dass die Eingabe in keiner Population und keiner Sprache eine mögliche Namenszuordnung hat |

## Datenbankprofil: 26. September 2026

Die Metadaten der Collections wurden am 2026-09-26T15:28:18.227Z gelesen, die Zufallsstichproben am 2026-09-26T15:31:54.045Z. Beide Dokumentanzahlen stammen jeweils getrennt aus den MongoDB-collStats-Metadaten der jeweiligen Collection und nicht aus einer unabhängigen vollständigen Zählung. Die allgemeine Collection enthält Namenseinträge, die länderspezifische Collection Paare aus Name und Land. Addieren Sie diese Zahlen nicht, um eine Gesamtzahl eindeutiger Namen oder eindeutiger Personen zu erhalten.

Für jede Collection hat MongoDB 5.000 Dokumente zufällig ausgewählt und die folgenden aggregierten Prüfungen serverseitig berechnet. Der öffentliche Bericht enthält keine Namen und keine Rohdaten. Es handelt sich um Beobachtungen von GenderAPI.io an der laufenden Datenbank, nicht um ein unabhängiges Audit oder einen eingefrorenen Bewertungsdatensatz. Die Prüfungen betreffen die Konsistenz der Zähler, nicht die Vorhersagegenauigkeit, die Zahl der Personen oder eindeutigen Namen und nicht die Abdeckung der API.

| Beobachtung | Allgemeine Einträge | Länderspezifische Einträge |
| --- | --- | --- |
| Collection | general | country-specific |
| Dokumentanzahl laut Metadaten | 2.483.220 | 4.080.692 |
| Gespeicherter eindeutiger Schlüssel | name | name + country |
| Zufällig ausgewählte Dokumente | 5.000 | 5.000 |
| Fehlgeschlagene numerische Prüfungen in der Stichprobe | 0 | 0 |
| male + female ungleich total in der Stichprobe | 0 | 0 |
| Gleiche Häufigkeiten für male und female in der Stichprobe | 124 | 94 |
| Feld updated_at in der Stichprobe vorhanden | 667 / 5.000 | 741 / 5.000 |

- [Datiertes aggregiertes Profil herunterladen (JSON)](https://www.genderapi.io/data-evidence/v2-dataset-profile.json)

## Was die Datenbankprüfungen zeigen

Die numerische Prüfung verlangt, dass total eine positive sichere Ganzzahl ist und die Häufigkeiten male und female endlich sind und zwischen null und total liegen. Eine separate Prüfung vergleicht male + female mit total. Alle Zähler in den Stichproben haben diese Prüfungen bestanden; das bedeutet weder, dass jeder Eintrag in den Collections konsistent ist, noch dass irgendeine Vorhersage richtig ist.

Gleiche Häufigkeiten für male und female traten bei 124 Einträgen der Stichprobe aus der allgemeinen Collection und bei 94 Einträgen der Stichprobe aus der länderspezifischen Collection auf. Das sind Gleichstände der gespeicherten Häufigkeiten, keine unabhängig geprüften mehrdeutigen Identitäten und kein Anteil unbekannter API-Ergebnisse. Tatsächliche API-Ergebnisse hängen von der Eingabe, der Verfügbarkeit von Redis, der Kandidatenauswahl und den KI-Einstellungen ab.

Eine separate Bestandsaufnahme des Felds country in der allgemeinen Collection am 2026-09-26T15:33:13.811Z ergab 244 verschiedene gespeicherte Werte: 239 im Format aus zwei Großbuchstaben und 5 in einem anderen Format. Die Übereinstimmung mit ISO, die Verteilung der Einträge nach Ländern und die Abdeckung unterstützter Länder wurden nicht gemessen. Diese Zahlen sind nicht die Anzahl unterstützter Länder.

In beiden Stichproben kamen keine Felder für Quelle oder Lizenz vor. Das belegt nicht, dass Herkunftsangaben in jedem Eintrag oder in externen Systemen fehlen: Das Vorhandensein oder Fehlen eines Felds ist kein Nachweis einer Quellenlizenz. Das Feld updated_at kam in einigen Einträgen als numerischer Wert vor, seine Werte und seine Bedeutung wurden jedoch nicht geprüft; es belegt weder die Aktualität der Daten noch einen Aktualisierungsplan.

V2 bedient Suchen im Datensatz aus Redis. Am 26. September 2026 hat GenderAPI.io als Eigentümer des Systems bestätigt, dass MongoDB und Redis denselben Datensatz enthalten. Diese Gleichwertigkeit beruht auf dieser Bestätigung: Ein unabhängiger Vergleich beider Datenbanken wurde nicht durchgeführt, und diese Prüfung steht noch aus. Die obige Bestandsaufnahme beschreibt gespeicherte Einträge; die Antwortabdeckung der API hängt außerdem von den gesendeten Eingaben, dem Kandidatenabgleich und den KI-Einstellungen ab. Die Stichproben wurden ohne festen Seed gezogen, ohne eingefrorenen Snapshot gelesen und ohne unabhängige Referenzlabels erstellt; sie erlauben keine Messung der Vorhersagegenauigkeit, der Kalibrierung oder der Antwortabdeckung.

- [Genauigkeit und Abdeckung messen](https://www.genderapi.io/de/accuracy-methodology)

## Die Angaben in der Antwort nachverfolgen

| Feld | Bedeutung | Einschränkung |
| --- | --- | --- |
| `input` | Wiederholt den gesendeten Typ, den Wert und den Länderkontext | Ein Eingabewert ist keine unabhängig geprüfte Identitätsangabe |
| `match.name / match.method` | Zeigt den ausgewählten Kandidaten und ob er normalisiert, als Bestandteil oder Teilstring extrahiert oder vom Modell abgeleitet wurde | Ein Treffer für einen Bestandteil garantiert nicht, dass aus dem vollständigen Namen oder der Kennung ein echter Vorname extrahiert wurde |
| `match.scope / match.country` | Zeigt, ob der ausgewählte Eintrag aus der länderspezifischen oder der globalen Suche stammt | Die Angabe eines Landes garantiert nicht, dass ein länderspezifischer Eintrag verfügbar war |
| `sample_count` | Im ausgewählten Eintrag gespeicherte Gesamtzahl; null bei KI-Inferenz | Muss weder eindeutige Personen noch unabhängig erhobene Beobachtungen noch die Stichprobengröße einer Genauigkeitsbewertung bedeuten |
| `confidence / confidence_kind` | Unterscheidet ein aus gespeicherten Häufigkeiten berechnetes Verhältnis von einem vom Modell gemeldeten Wert | Keiner dieser Werte ist eine geprüfte Wahrscheinlichkeit für die Geschlechtsidentität einer Person |
| `country / country_source` | Ländermetadaten des zurückgegebenen Eintrags oder eine von KI gemeldete Länderzuordnung des Namens, sofern verfügbar | Bedeutet weder Nationalität noch Wohnort noch geprüfte Herkunft und belegt nicht, dass das gesendete Land getroffen wurde |

- [Vollständige Dokumentation der V2-Antwort](https://www.genderapi.io/de/docs/v2/responses)

## Wie der Abgleich der Eingabe das Ergebnis beeinflusst

Die Suche im Datensatz normalisiert den Text und leitet daraus Kandidaten ab. Bei E-Mail-Adressen stammen die Kandidaten aus dem Teil vor dem @; bei Benutzernamen wird ein optionales führendes @ entfernt. Gewöhnliche Suchen nach E-Mail-Adressen und Benutzernamen können außerdem Teilstrings begrenzter Länge prüfen. Stehen mehrere Kandidateneinträge zur Verfügung, wird derjenige mit der größten gespeicherten Gesamthäufigkeit ausgewählt; das kann ein anderer Bestandteil als der beabsichtigte Vorname sein.

Wird ein Länderkontext angegeben, prüft die Suche für jeden Kandidaten den länderspezifischen Eintrag und, falls keiner vorhanden ist, den globalen Eintrag. Das endgültige Ergebnis gibt den ausgewählten Treffer an. Ein mehrdeutiger länderspezifischer Eintrag wird für diesen Kandidaten nicht automatisch durch den globalen Eintrag ersetzt.

Der gewöhnliche KI-Prompt sucht nach einem erkennbaren Vornamen. forceToGenderize erlaubt zusätzlich Zuordnungen auf Grundlage persönlicher Spitznamen oder Aliase: In diesem Modus ist ein Geschlecht ungleich null zusammen mit name: null ein gültiges Ergebnis. Das sind unterschiedliche Inferenzaufgaben, die getrennt bewertet werden müssen.

- [Suche nach Namen](https://www.genderapi.io/de/docs/v2/gender-from-name)
- [Suche nach E-Mail-Adressen](https://www.genderapi.io/de/docs/v2/gender-from-email)
- [Suche nach Benutzernamen](https://www.genderapi.io/de/docs/v2/gender-from-username)
- [KI-Optionen](https://www.genderapi.io/de/docs/v2/ai-options)

## Suche im Datensatz und Verarbeitung durch KI

Wird KI eingesetzt, übergibt V2 den gesendeten type, den value und den Länderkontext an den konfigurierten KI-Inferenzdienst. Bei E-Mail-Adressen weist der Prompt das Modell an, die Domain und das Suffix nach einem + zu ignorieren; das garantiert nicht, dass diese Zeichen vor der Verarbeitung durch KI aus dem Wert entfernt werden. Wenn Ihr Ablauf eine Vorhersage nur aus dem Datensatz verlangt, verwenden Sie ai_mode: off ohne forceToGenderize.

Die Validierung der KI-Antwort prüft die JSON-Felder, ihre Typen und ihre gegenseitige Konsistenz. Sie belegt nicht, dass der zurückgegebene Name, die Geschlechtszuordnung oder die Länderzuordnung zutreffen. Das öffentliche Ergebnis enthält weder eine Kennung oder Version des Modells noch eine Quelle, die seine Inferenz begründet.

| Option | Inferenzweg | Zurückgegebene Angaben |
| --- | --- | --- |
| ai_mode: off | Nur Suche im Datensatz | Metadaten des ausgewählten Eintrags oder ein unbekanntes Ergebnis ohne ausgewählten Eintrag |
| ai_mode: fallback | Prüft zuerst den Datensatz; setzt KI ein, wenn kein Geschlecht zurückgegeben wurde | Angaben aus dem endgültigen Weg, keine kombinierte Stichprobe aus Datensatz und KI |
| ai_mode: always | Verwendet direkt den konfigurierten KI-Inferenzweg | Vom Modell gemeldeter Wert oder ein unbekanntes Ergebnis mit Konfidenz null; sample_count ist immer null |
| forceToGenderize: true | Prüft den Datensatz und setzt bei offenem Ergebnis KI ein, die Spitznamen berücksichtigt | Angaben aus dem Datensatz oder eine vom Modell gemeldete Spitznamen-Zuordnung; name kann null sein |

- [KI-Optionen und Kompatibilität der Parameter](https://www.genderapi.io/de/docs/v2/ai-options)
- [Datenschutzerklärung](https://www.genderapi.io/de/privacy-policy)

## Quellendokumentation, die noch nicht veröffentlicht wurde

Hier wurde kein geprüfter Quellenkatalog veröffentlicht. Der Antwortvertrag und das Verhalten der Implementierung allein genügen nicht, um die Herkunft der Daten, das Nutzungsrecht an einer Quelle, ihre Repräsentativität oder die Qualität ihrer Labels zu prüfen. Bevor Aussagen zu bestimmten Quellen gemacht werden, müssen die folgenden Angaben dokumentiert und geprüft sein.

Diese Übersicht über die Dokumentation stellt weder fest, ob die ursprünglichen Quellen lizenziert sind oder nicht, noch ob sie vollständig oder unvollständig sind. Sie beschreibt die Grenzen der öffentlich verfügbaren Belege. Wenden Sie sich an GenderAPI.io, wenn Ihr Anwendungsfall die Bewertung einer bestimmten Quelle erfordert.

| Beleg | Erforderliches Dokument | Öffentlicher Status |
| --- | --- | --- |
| Herkunft und Nutzungsrecht | Benannte Quelle oder benannter Herausgeber, Erhebungszeitraum, Lizenz oder eine andere dokumentierte Nutzungsgrundlage | Hier wurde kein geprüfter Katalog veröffentlicht |
| Verarbeitungsverlauf | Transformationen, Normalisierung, Entfernung von Duplikaten, Aggregation sowie jeder synthetische oder von einem Modell erzeugte Beitrag | Ergibt sich nicht aus dem Label source: dataset |
| Abdeckung der Population | Abdeckung von Ländern und Schriftsystemen, Auswahlverfahren, Labeldefinitionen und dokumentierte Verzerrungen | Hier wurden keine unabhängig bewerteten Abdeckungsdaten veröffentlicht |
| Aktualität | Snapshot-Kennungen, Aktualisierungsdaten einzelner Quellen und ein unterstützter Aktualisierungsplan | Die V2-Antwort enthält weder Angaben zur Aktualität einzelner Einträge noch eine Snapshot-Kennung |
| Qualität und Korrekturen | Validierungsergebnisse, Prüfungen auf Überschneidungen, Umgang mit Korrekturen und Löschungen sowie Verantwortung für die Prüfung | Hier wurden keine Auditergebnisse zu einzelnen Quellen veröffentlicht |

## Datenschutz, Verarbeitung und verantwortungsvolle Nutzung

Die Herkunft der Quellen, die Verarbeitung personenbezogener Daten und die rechtlichen Bedingungen sind getrennte Fragen. Verarbeitungsrollen, Aufbewahrungsfristen, Anbieter und Vertragsbedingungen sind in den aktuell veröffentlichten Richtlinien beschrieben. Diese technische Anleitung begründet keine neuen Zusagen zur Datenaufbewahrung und bescheinigt keine Rechtskonformität.

Senden Sie nur die Angaben, die Ihr Ablauf benötigt. Behalten Sie Konfidenzarten und unbekannte Ergebnisse bei und stellen Sie eine Inferenz nicht als selbst angegebene Identität einer Person dar. Treffen Sie keine folgenreichen Entscheidungen über eine Person auf Grundlage eines abgeleiteten Geschlechts.

- [Datenschutzerklärung](https://www.genderapi.io/de/privacy-policy)
- [Auftragsverarbeitungsvertrag](https://www.genderapi.io/de/data-processing-agreement)
- [Verzeichnis der Unterauftragsverarbeiter](https://www.genderapi.io/de/subprocessors)
- [Informationen zur DSGVO](https://www.genderapi.io/de/gdpr-compliance)
- [Nutzungsbedingungen](https://www.genderapi.io/de/terms)
- [GenderAPI.io kontaktieren](https://www.genderapi.io/de/contact)

## Belege zur Genauigkeit und Änderungsverlauf

Das Quellenlabel erklärt den Inferenzweg, nicht seine gemessene Qualität. Die Anleitung zur Genauigkeit zeigt, wie Sie Ergebnisse in Antworten, Antwortabdeckung, Fehler und die für eine reproduzierbare Bewertung nötigen Angaben unterscheiden.

| Datum | Dokumentversion | Änderung |
| --- | --- | --- |
| 2026-09-28 | 1.0.0 | Deutsche Fassung der datierten MongoDB-Bestandsaufnahme, der Konsistenzprüfungen an Stichproben, der V2-Felder source und match, der Grenzen der KI-Verarbeitung und der verbleibenden Lücken im Quellenkatalog. Die Gleichwertigkeit von MongoDB und Redis beruht auf der Bestätigung durch GenderAPI.io vom 26. September 2026; der unabhängige Vergleich steht noch aus. Es wurden weder ein Genauigkeitswert in Prozent noch eine Aussage zur Quellenlizenz hinzugefügt. |

- [Genauigkeit und Konfidenz](https://www.genderapi.io/de/accuracy-methodology)