Batch GenderAPI | Bis zu 100 Namen pro Anfrage

Mehrfachanfrage im Überblick

Bis zu 100 Namen verarbeiten

Senden Sie ein data-Array und erhalten Sie für jeden Datensatz ein Ergebnis. Ergänzen Sie eine id aus Ihrem System, um jede Einschätzung zuverlässig ihrem Quelldatensatz zuzuordnen.

MethodePOST

Maximum100 Namen

AuthentifizierungBearer Token

KI-UnterstützungNicht unterstützt

Mehrfachanfragen verwenden keine KI-Inferenz.

askToAI und forceToGenderize sind nicht verfügbar. Für Namen in nicht-lateinischen Schriftsystemen oder Eingaben, die KI-Unterstützung benötigen, verwenden Sie den Endpunkt für einzelne Namen.

HDR

Erforderliche HTTP-Header

Mehrfachanfrage autorisieren

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-Request-Body

Parameter

Feld	Typ	Status	Beschreibung
`data`	object[]	Erforderlich	Array mit 1 bis 100 Namensdatensätzen.
`data[].name`	string	Erforderlich	Zu analysierender Vorname.
`data[].country`	string	Optional	Ländercode nach ISO 3166-1 Alpha-2. Wenn kein Ergebnis für das Land vorliegt, wird auf das globale Ergebnis zurückgegriffen.
`data[].id`	string \| integer	Optional	Ihre Datensatz-ID; sie wird unverändert zurückgegeben, damit Ergebnis und Eingabe zuverlässig zugeordnet werden können.

Fallback auf globales Ergebnis

Wenn für das angegebene Land keine Übereinstimmung vorhanden ist, gibt GenderAPI das verfügbare globale Ergebnis zurück. Verwenden Sie ISO-3166-1-Alpha-2-Codes wie DE, IT oder US.

Request-Payload

Das data-Array erstellen

JSON

{
  "data": [
    { "name": "Andrea", "country": "DE", "id": "123" },
    { "name": "Andrea", "country": "IT", "id": "456" },
    { "name": "James", "country": "US", "id": "789" }
  ]
}

Codebeispiele

Mehrere Namen senden

cURL

curl -X POST "https://api.genderapi.io/api/name/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"name":"Andrea","country":"DE","id":"123"},{"name":"Andrea","country":"IT","id":"456"}]}'

JavaScript

const data = [
  { name: "Andrea", country: "DE", id: "123" },
  { name: "Andrea", country: "IT", id: "456" }
];

const response = await fetch("https://api.genderapi.io/api/name/multi/country", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200-Antwort

Ergebnisse den eigenen Datensätzen zuordnen

JSON

{
  "status": true,
  "used_credits": 2,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "andrea", "q": "Andrea", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "andrea", "q": "Andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "duration": "5ms"
}

Antwortfelder

Feld	Typ	Beschreibung
`status`	boolean	Gibt an, ob die Mehrfachanfrage erfolgreich abgeschlossen wurde.
`used_credits`	integer	Für alle übermittelten Namen verbrauchte Credits.
`remaining_credits`	integer	Nach der Anfrage verfügbare Credits.
`expires`	integer	Ablaufzeit des Pakets als UNIX-Zeitstempel.
`names`	object[]	Geordnete Sammlung der Ergebnisse.
`names[].name`	string	Für die Einschätzung verwendeter normalisierter Name.
`names[].q`	string	Ursprünglich übermittelter Name.
`names[].gender`	string \| null	Geschätzter Wert: male, female oder null.
`names[].country`	string	Für dieses Ergebnis berücksichtigter Ländercode.
`names[].total_names`	integer	Anzahl der Stichproben, auf denen dieses Ergebnis beruht.
`names[].probability`	integer	Wahrscheinlichkeit der Einschätzung in Prozent.
`names[].id`	string \| integer	Zur Zuordnung zurückgegebene Eingabe-ID.
`duration`	string	Gesamte serverseitige Verarbeitungsdauer.

Maximal 100 Datensätze pro Anfrage

Validieren Sie das Array vor dem Senden und verwenden Sie eine eindeutige id für die deterministische Zuordnung. Teilen Sie größere Datensätze in Batches mit höchstens 100 Namen.

Nächste Anleitung

Geschlecht anhand einer E-Mail bestimmen

Einzelne E-Mail-AnfrageNamen aus E-Mail extrahieren und analysieren →Einzelne NamensanfrageKI-Unterstützung für einen Namen verwenden →