Geschlecht aus bis zu 50 E-Mail-Adressen bestimmen

Übersicht zur Massenanfrage

Bis zu 50 E-Mail-Adressen verarbeiten

Senden Sie einedataArray. GenderAPI extrahiert aus jeder Adresse einen wahrscheinlichen Namen und gibt die entsprechende Vorhersage zurück; Ihre optionaleidsorgt für deterministische Datenbankkorrelation.

MethodPOST

Maximum50 E-Mails

AuthenticationBearer-Token

Ergebnisformatnames[]

50 E-Mails maxNamenerkennungErgebnisse mit Länderbewusstsein

HDR

Erforderliche HTTP-Header

Autorisieren Sie die Bulk-Anfrage

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-Anfragekörper

Parameter

Field	Type	Requirement	Description
`data`	object[]	Pflichtfeld	Array mit zwischen 1 und 50 E-Mail-Einträgen.
`data[].email`	string	Pflichtfeld	E-Mail-Adresse, aus der GenderAPI einen wahrscheinlichen Vorname extrahiert.
`data[].country`	string	Optional	ISO 3166-1 alpha-2-Landcode, der als regionaler Kontext verwendet wird.
`data[].id`	string \| integer	Optional	Ihre Eintrags-ID, die unverändert mit dem entsprechenden Ergebnis zurückgegeben wird.

Datensatzabgleich

Verwenden Sie eine eindeutigeidFür jedes Element. GenderAPI gibt es mit dem Ergebnis des jeweiligen Elements zurück, sodass Sie das richtige Datenbankfeld aktualisieren können, ohne auf die Position im Array zurückzugreifen.

Anfrage-Payload

Bauen Sie das E-Mail-Array zusammen

JSON

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

Codebeispiele

Ein mehrfaches E-Mail-Anfrage senden

cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200-Antwort

Extrahierte Namen und Vorhersagen

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Antwortfelder

Field	Type	Description
`status`	boolean	Ob die Bulk-Anfrage erfolgreich abgeschlossen wurde.
`used_credits`	integer	Credits, die in allen eingereichten E-Mails verbraucht wurden.
`remaining_credits`	integer	Credits, die nach dem Vorgang verbleiben.
`expires`	integer	Verfallszeit des Pakets als UNIX-Timestamp.
`names`	object[]	Gekennzeichnete Sammlung der Ergebnisse für die eingereichten E-Mails.
`names[].name`	string	Vorname, der aus der E-Mail-Adresse extrahiert wurde.
`names[].q`	string	Originale E-Mail, die im Antrag eingereicht wurde.
`names[].gender`	string \| null	Vorhersagter Wert: männlich, weiblich oder null.
`names[].country`	string	Landcode, der für dieses Ergebnis berücksichtigt wurde.
`names[].total_names`	integer	Anzahl der Proben, die dieses Ergebnis unterstützen.
`names[].probability`	integer	Vorhersagegenauigkeit in Prozent.
`names[].id`	string \| integer	Eingabekennung, die für die Korrelation des Datensatzes zurückgegeben wird.
`duration`	string	Gesamte Serververarbeitungszeit.

Halten Sie jede Anfrage auf 50 Einträge begrenzt

Validieren Sie jede Adresse und teilen Sie größere Datensätze in Batches von maximal 50 auf. Prüfen Sie das extrahiertename and probabilityvor der Anwendung des Ergebnisses.

Nächste Anleitung

Bestimmen des Geschlechts aus einem Benutzernamen

Einzelanfrage für BenutzernamenExtrahieren eines Namens aus einem Benutzernamen →Einzelanfrage für E-Mail-AdresseAI-Fallback für eine E-Mail verwenden →