Geslacht bepalen op basis van tot 50 e-mailadressen

Overzicht van bulk-aanvragen

Verwerk tot 50 e-mailadressen

Verstuur eendataarray. GenderAPI extrahereert uit elke adres een waarschijnlijk naam en retourneert de bijbehorende voorspelling; je optioneleidzorgt voor deterministische databasecorrelatie.

MethodPOST

Maximum50 e-mails

AuthenticationBearer token

Resultaatformaatnames[]

50 e-mails maxNaamextraheringsprocesResultaten die landbewust zijn

HDR

Verplichte HTTP-header

Autoriseer de bulk-aanvraag

Content-Typeapplication/json

AuthorizationBearer UW_API_SLEUTEL

JSON-aanvraaglichaam

Parameters

Field	Type	Requirement	Description
`data`	object[]	Verplicht	Array met tussen 1 en 50 e-mailregistraties.
`data[].email`	string	Verplicht	E-mailadres uit hetwelk GenderAPI een waarschijnlijke voorvoegsel extrahereert.
`data[].country`	string	Optioneel	ISO 3166-1 alpha-2 landcode gebruikt als regionale context.
`data[].id`	string \| integer	Optioneel	Uw registratieidentificator, geretourneerd onveranderd met de bijbehorende resultaat.

Record matchen

Gebruik een uniekeidVoor elk item. GenderAPI retourneert het samen met het resultaat van dat item, zodat u de juiste database-entiteit kunt bijwerken zonder alleen op de positie in de array te vertrouwen.

Aanvraagpayload

Bouw de e-mailarray

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

Codevoorbeelden

Stuur een aanvraag met meerdere e-mails

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

Gehaald namen en voorspellingen

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

Antwoordvelden

Field	Type	Description
`status`	boolean	Of de bulkverzoek succesvol is afgerond.
`used_credits`	integer	Credits verbruikt over alle ingediende e-mails.
`remaining_credits`	integer	Credits beschikbaar na de aanvraag.
`expires`	integer	Verloopdatum van de pakketten als UNIX-timestamp.
`names`	object[]	Gestructureerde collectie van resultaten voor de ingediende e-mails.
`names[].name`	string	Voornaam geëxtraheerd uit de e-mailadres.
`names[].q`	string	Oorspronkelijke e-mail ingediend in de aanvraag.
`names[].gender`	string \| null	Gepredigeerde waarde: man, vrouw of null.
`names[].country`	string	Landcode overwogen voor dit resultaat.
`names[].total_names`	integer	Aantal monsters die deze resultaat ondersteunen.
`names[].probability`	integer	Vertrouwensniveau als percentage.
`names[].id`	string \| integer	Inputidentificator geretourneerd voor recordcorrelatie.
`duration`	string	Totaal serververwerkings tijd.

Houd elke aanvraag binnen 50 records

Valideer elke adresgegevens en verdeel grotere datasets in batches van maximaal 50. Controleer de geextraheerdename and probabilityvoor toepassing van een resultaat.

Volgende handleiding

Bepaal het geslacht op basis van een gebruikersnaam

Gebruikersnaam: enkele aanvraagExtraher een naam uit één gebruikersnaam →E-mail: enkele aanvraagAI fallback gebruiken voor één e-mail →