Kön från e-post API | Dokumentation för enskild förfrågan

Översikt över förfrågan

Från e-postadress till prognos

GenderAPI analyserar adressens lokala del, extraherar det mest sannolika förnamnet och använder namnet i könsprognosen. Ange landskontext när användarens region är känd.

01E-postindatamichael.smith@example.com

02NamnextraktionMichael

03Prognosmale · 97%

MetodPOST

Content typeapplication/json

AutentiseringBearer-token

Kreditkostnad1 uppslagning

HDR

Obligatoriska HTTP-headers

Auktorisera förfrågan

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-body för förfrågan

Parametrar

Parameter	Typ	Krav	Beskrivning
`email`	string	Obligatorisk	E-postadressen som ska analyseras. GenderAPI extraherar det mest sannolika förnamnet före prognosen.
`country`	string	Valfri	Landskod enligt ISO 3166-1 alpha-2, exempelvis SE eller US, som ger regional kontext.
`askToAI`	boolean	Valfri	När värdet är true används AI-stöd om det extraherade namnet saknar databasresultat.

AI-stöd

askToAI bedöms efter namnextraktionen och endast när det extraherade namnet inte hittas i databasen. E-postendpointen stöder inte forceToGenderize.

Kodexempel

Skicka en e-postförfrågan

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":"SE","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: "SE", 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": "SE", "askToAI": True}
)
print(response.json())

200-svar

Extraherat namn och prognos

JSON

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

Svarsfält

Fält	Typ	Beskrivning
`status`	boolean	Anger om förfrågan slutfördes utan fel.
`used_credits`	integer	Krediter som förbrukades av förfrågan.
`remaining_credits`	integer	Krediter som återstår efter förfrågan.
`expires`	integer	Paketets utgångstid som en UNIX-tidsstämpel.
`q`	string	Ursprunglig e-postadress i förfrågan.
`name`	string	Förnamn som extraherades ur e-postadressen.
`gender`	string \| null	Prognostiserat värde: male, female eller null.
`country`	string	Landskod som användes för prognosen.
`total_names`	integer	Antal namnposter som stöder prognosen.
`probability`	integer	Prognosens sannolikhet i procent.
`duration`	string	Serverns behandlingstid.

Använd en giltig, fullständig e-postadress

Namnextraktionen beror på adressens struktur. Generiska inkorgar, alias och lokala delar utan identifierbara namn kan sakna resultat; kontrollera name, gender och probability innan prognosen används. E-postförfrågningar lagras aldrig.

Nästa guide

Analysera flera e-postadresser

Flera e-postförfrågningarBearbeta flera adresser i en förfrågan →Enskild namnförfråganSkicka ett känt förnamn direkt →