Finn kjønn fra flere e-postadresser

Oversikt over masseoppslag

Behandle opptil 50 e-postadresser

Send en data-liste. GenderAPI henter et sannsynlig navn fra hver adresse og returnerer den tilhørende prediksjonen. En valgfri id gir entydig kobling til postene i systemet ditt.

MetodePOST

Maksimum50 e-postadresser

AutentiseringBearer-token

Resultatformatnames[]

Maks. 50 e-postadresserNavneuttrekkResultater med landkontekst

HDR

Påkrevde HTTP-headere

Autoriser masseoppslaget

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-body for forespørselen

Parametere

Felt	Type	Krav	Beskrivelse
`data`	object[]	Påkrevd	En liste med mellom 1 og 50 e-postposter.
`data[].email`	string	Påkrevd	E-postadressen GenderAPI henter et sannsynlig fornavn fra.
`data[].country`	string	Valgfri	ISO 3166-1 alfa-2-landkode som brukes som regional kontekst.
`data[].id`	string \| integer	Valgfri	Din post-ID, returnert uendret sammen med det tilhørende resultatet.

Kobling av poster

Bruk en unik id for hvert element. GenderAPI returnerer den sammen med elementets resultat, slik at du kan oppdatere riktig post uten å være avhengig av plasseringen i listen.

Payload for forespørselen

Bygg e-postlisten

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 forespørsel med flere e-postadresser

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

Navneuttrekk og prediksjoner

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

Svarfelt

Felt	Type	Beskrivelse
`status`	boolean	Om masseoppslaget ble fullført uten feil.
`used_credits`	integer	Kreditter brukt for alle innsendte e-postadresser.
`remaining_credits`	integer	Kreditter som er tilgjengelige etter forespørselen.
`expires`	integer	Pakkens utløpstid som UNIX-tidsstempel.
`names`	object[]	Sortert liste med resultater for de innsendte e-postadressene.
`names[].name`	string	Fornavnet som ble hentet ut fra e-postadressen.
`names[].q`	string	Den opprinnelige e-postadressen som ble sendt inn.
`names[].gender`	string \| null	Predikert verdi: male, female eller null.
`names[].country`	string	Landkoden som ble brukt for resultatet.
`names[].total_names`	integer	Antall navneforekomster som støtter resultatet.
`names[].probability`	integer	Prediksjonens konfidens uttrykt i prosent.
`names[].id`	string \| integer	Inndata-ID som returneres for kobling av poster.
`duration`	string	Samlet behandlingstid på serveren.

Begrens hver forespørsel til 50 poster

Valider hver adresse, og del større datasett i grupper med maksimalt 50 poster. Kontroller name og probability før du bruker et resultat. E-postforespørsler lagres ikke.

Neste veiledning

Finn kjønn fra et brukernavn

Enkeltforespørsel for brukernavnHent ut et navn fra ett brukernavn →Enkeltforespørsel for e-postBruk KI-reserve for én e-postadresse →