Gender uit e-mail API – enkele aanvraag

Aanvraagoverzicht

Van e-mailadres naar voorspelling

GenderAPI analyseert het lokale deel van het adres, leidt de waarschijnlijkste voornaam af en gebruikt die naam voor de genderinschatting. Voeg landcontext toe wanneer de regio bekend is.

01E-mailinvoersophie.devries@example.com

02NaamextractieSophie

03Voorspellingfemale · 98%

MethodePOST

Contenttypeapplication/json

AuthenticatieBearer-token

Creditkosten1 opzoeking

HDR

Vereiste HTTP-headers

Autoriseer de aanvraag

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-aanvraagbody

Parameters

Parameter	Type	Vereiste	Beschrijving
`email`	string	Verplicht	E-mailadres om te analyseren. GenderAPI leidt vóór de voorspelling de waarschijnlijkste voornaam af.
`country`	string	Optioneel	ISO 3166-1 alpha-2-landcode, zoals NL of BE, voor regionale context.
`askToAI`	boolean	Optioneel	Gebruik bij true AI wanneer de afgeleide naam geen databaseresultaat heeft.

AI-ondersteuning

askToAI wordt pas na de naamextractie beoordeeld en alleen wanneer de afgeleide naam niet in de database staat. Het e-mailendpoint accepteert geen forceToGenderize.

Codevoorbeelden

Verstuur een e-mailaanvraag

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"sophie.devries@example.com","country":"NL","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "sophie.devries@example.com", country: "NL", askToAI: true })
});
const data = await response.json();

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "sophie.devries@example.com", "country": "NL", "askToAI": True}
)
print(response.json())

200-respons

Afgeleide naam en voorspelling

JSON

{
  "status": true, "used_credits": 1,
  "remaining_credits": 4999, "expires": 1743659200,
  "q": "sophie.devries@example.com", "name": "Sophie",
  "gender": "female", "country": "NL",
  "total_names": 10345, "probability": 98,
  "duration": "5ms"
}

Responsvelden

Veld	Type	Beschrijving
`status`	boolean	Of de aanvraag met succes is voltooid.
`used_credits`	integer	Credits die deze aanvraag heeft verbruikt.
`remaining_credits`	integer	Credits die na de aanvraag beschikbaar zijn.
`expires`	integer	Vervaldatum van het pakket als UNIX-tijdstempel.
`q`	string	Oorspronkelijk e-mailadres uit de aanvraag.
`name`	string	Voornaam die uit het e-mailadres is afgeleid.
`gender`	string \| null	Voorspelde waarde: male, female of null.
`country`	string	Landcode die voor de voorspelling is gebruikt.
`total_names`	integer	Aantal voorbeelden waarop de voorspelling berust.
`probability`	integer	Waarschijnlijkheid van de voorspelling als percentage.
`duration`	string	Verwerkingstijd op de server.

Gebruik een geldig, volledig e-mailadres

Naamextractie is afhankelijk van de adresstructuur. Algemene inboxen, aliassen of lokale delen zonder herkenbare naam kunnen geen resultaat geven. Controleer name, gender en probability voordat u de voorspelling gebruikt.

Privacy van e-mailquery's

E-mailquery's worden niet opgeslagen. Verstuur alleen gegevens die u rechtmatig mag verwerken en raadpleeg het Privacybeleid.

Volgende handleiding

Analyseer meerdere e-mailadressen

Meervoudige e-mailaanvraagVerwerk meerdere adressen in één aanvraag →Enkele naamaanvraagVerstuur een bekende voornaam rechtstreeks →