Bestäm kön från upp till 50 e-postadresser

Översikt över massbegäran

Bearbeta upp till 50 e-postadresser

Skicka endataarray. GenderAPI extraherar ett troligt namn från varje adress och returnerar den matchande förutsägelsen; din valfriaidgör databasens korrelation deterministisk.

MethodPOST

Maximum50 e-postadresser

AuthenticationBärer-token

Resultatformatnames[]

50 e-postadresser maxNamnextraktionResultat med landsspecifik information

HDR

Krävda HTTP-huvudfält

Autentisera bulk-förfrågan

Content-Typeapplication/json

AuthorizationBearer DITT_API_NYCKEL

JSON-förfrågekropp

Parametrar

Field	Type	Requirement	Description
`data`	object[]	Påkrävt	Array innehållande mellan 1 och 50 e-postposter.
`data[].email`	string	Påkrävt	E-postadress från vilken GenderAPI extraherar ett troligt förnamn.
`data[].country`	string	Valfritt	ISO 3166-1 alpha-2 landkod används som regionell kontext.
`data[].id`	string \| integer	Valfritt	Din postidentifierare, returneras oändrad med motsvarande resultat.

Sökning av matchande post

Använd en unikidFör varje post. GenderAPI returnerar den tillsammans med det resultat som hör till den specifika posten, så att du kan uppdatera den rätta databasposten utan att bero på position i arrayen.

Anfrågarnas innehåll

Bygg email-arrayen

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

Kodexempel

Skicka en förfrågan med flera 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

Extraherade namn och förutsägelser

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

Svarsfält

Field	Type	Description
`status`	boolean	Om bulk-förfrågan slutfördes framgångsrikt.
`used_credits`	integer	Krediterna som förbrukats i alla inlämnade e-postmeddelanden.
`remaining_credits`	integer	Krediter som är tillgängliga efter begäran.
`expires`	integer	Paketets utgångstid som en UNIX-tidstempel.
`names`	object[]	Ordnad samling av resultat för de inlämnade e-postadresserna.
`names[].name`	string	Förnamn extraherat från e-postadressen.
`names[].q`	string	Original e-postadress som inlämnades i begäran.
`names[].gender`	string \| null	Förutsägda värden: manlig, kvinnlig eller null.
`names[].country`	string	Landskod som används för detta resultat.
`names[].total_names`	integer	Antal prov som stödjer detta resultat.
`names[].probability`	integer	Förutsägelsekonfidens som procent.
`names[].id`	string \| integer	Inmatningsidentifierare som returneras för registreringskoppling.
`duration`	string	Total tid för serverbehandling.

Behåll varje begäran inom 50 poster

Validera varje adress och dela större datamängder in i batchar som inte överskrider 50. Kontrollera den extraheradename and probabilityinforen innan du tillämpar ett resultat.

Nästa guide

Bestäm kön från ett användarnamn

Användarnamn – enkel begäranExtrahera ett namn från ett användarnamn →E-post – enkel begäranAnvänd AI-fallbädd för en e-post →