Afgør køn fra op til 50 e-mail-adresser

Oversigt over bulk-forespørgsler

Behandle op til 50 e-mail-adresser

Send endataarray. GenderAPI extrahererer et sandsynlig navn fra hvert adresse og returnerer den tilsvarende prædiktion; din valgfriidgør databasekorrelationen deterministisk.

MethodPOST

Maximum50 e-mail-adresser

AuthenticationBærer-token

Resultatformatnames[]

50 e-mail-adresser maxNavnextraktionResultater med landsspecifik forståelse

HDR

Obligatoriske HTTP-hedre

Autoriser den massive forespørgsel

Content-Typeapplication/json

AuthorizationBearer DIN_API_NYTTE

JSON-forespørgsmål-krop

Parametre

Field	Type	Requirement	Description
`data`	object[]	Påkrævet	Array indeholdende mellem 1 og 50 e-mail-poster.
`data[].email`	string	Påkrævet	E-mail-adresse, fra hvilken GenderAPI ekstraherer et sandsynligt første navn.
`data[].country`	string	Valgfrit	ISO 3166-1 alpha-2-landkode bruges som regional kontekst.
`data[].id`	string \| integer	Valgfrit	Din postidentifikator, returneres uændret med den tilhørende resultater.

Postering af matchende data

Brug et uniktidFor hvert element. GenderAPI returnerer det sammen med resultatet for det pågældende element, så du kan opdatere den korrekte databasepost uden at afhænge af positionen i arrayet.

Anmodningsindhold

Byg email-arrayet

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" }
  ]
}

Kodeeksempler

Send en anmodning med flere email-adresser

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-svar

Extractede navne og forudsigelser

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"
}

Responsfelter

Field	Type	Description
`status`	boolean	Om bulk-afsendelsen blev udført succesfuldt.
`used_credits`	integer	Kreditter forbrugt over alle indsendte e-mails.
`remaining_credits`	integer	Kreditter tilgængelige efter forespørgslen.
`expires`	integer	Pakkeudgårsdato som UNIX-tidstamp.
`names`	object[]	Ordnet samling af resultater for de indsendte e-mails.
`names[].name`	string	Fornavn udtrækket fra e-mail-adressen.
`names[].q`	string	Original e-mail indsendt i forespørgslen.
`names[].gender`	string \| null	Forudsiget værdi: mand, kvinde eller null.
`names[].country`	string	Landskode anvendt for dette resultat.
`names[].total_names`	integer	Antallet af eksempler, der støtter dette resultat.
`names[].probability`	integer	Forudsigelseskonfidens som procent.
`names[].id`	string \| integer	Indtastningsidentifikator, der returneres til oplysningssammenhæng.
`duration`	string	Samlet serverbehandlingstid.

Hold hvert anmodning inden for 50 registreringer

Validér hver adresse og opdel større datamængder i batcher på ikke mere end 50. Tjek den udtrækkedename and probabilityfør du anvender et resultat.

Næste vejledning

Afgør køn fra et brugernavn

Brugernavn - enkelt anmodningUdtræk et navn fra et brugernavn →E-mail - enkelt anmodningBrug AI-fald til én e-mail →