Køn ud fra e-mail API – Dokumentation til enkelt forespørgsel

Oversigt over forespørgslen

Fra e-mailadresse til estimering

GenderAPI analyserer adressens lokale del, udtrækker det mest sandsynlige fornavn og bruger navnet til kønsestimeringen. Tilføj landekontekst, når brugerens region er kendt.

01E-mailinputmichael.smith@example.com

02NavneudtrækMichael

03Estimeringmale · 97%

MetodePOST

Indholdstypeapplication/json

GodkendelseBearer-token

Kreditforbrug1 opslag

Beskyttelse af e-maildata: E-mailforespørgsler gemmes ikke af GenderAPI. Se privatlivspolitikken for detaljer.

HDR

Påkrævede HTTP-headere

Godkend forespørgslen

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-request body

Parametre

Parameter	Type	Krav	Beskrivelse
`email`	string	Påkrævet	E-mailadressen, der skal analyseres. GenderAPI udtrækker det mest sandsynlige fornavn før estimeringen.
`country`	string	Valgfri	ISO 3166-1 alpha-2-landekode, f.eks. DK eller US, som tilføjer regional kontekst.
`askToAI`	boolean	Valgfri	Når værdien er true, bruges AI som fallback, hvis det udtrukne navn ikke giver et databaseresultat.

AI-fallback

askToAI vurderes efter navneudtrækket og kun, når det udtrukne navn ikke findes i databasen. E-mail-endpointet accepterer ikke forceToGenderize.

Kodeeksempler

Send en e-mailforespørgsel

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"michael.smith@example.com","country":"DK","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: "michael.smith@example.com", country: "DK", 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": "michael.smith@example.com", "country": "DK", "askToAI": True}
)
print(response.json())

200-svar

Udtrukket navn og estimering

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "michael.smith@example.com",
  "name": "Michael",
  "gender": "male",
  "country": "DK",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

Svarfelter

Felt	Type	Beskrivelse
`status`	boolean	Angiver, om forespørgslen blev gennemført korrekt.
`used_credits`	integer	Antal kreditter, som forespørgslen brugte.
`remaining_credits`	integer	Tilgængelige kreditter efter forespørgslen.
`expires`	integer	Pakkens udløbstid som UNIX-tidsstempel.
`q`	string	Den oprindelige e-mailadresse i forespørgslen.
`name`	string	Fornavnet, der blev udtrukket fra e-mailadressen.
`gender`	string \| null	Estimeret værdi: male, female eller null.
`country`	string	Landekoden, der indgik i estimeringen.
`total_names`	integer	Antal navneposter, som understøtter estimeringen.
`probability`	integer	Estimeringens sandsynlighed i procent.
`duration`	string	Serverens behandlingstid.

Brug en gyldig, komplet e-mailadresse

Navneudtrækket afhænger af adressens struktur. Generiske indbakker, aliasser eller lokale dele uden genkendelige navne giver muligvis intet resultat. Kontrollér name, gender og probability, før en estimering bruges.

Næste vejledning

Analysér flere e-mailadresser

Forespørgsel med flere e-mailsBehandl flere adresser i én forespørgsel →Enkelt navneforespørgselSend et kendt fornavn direkte →