E-postadan Cinsiyet API

Sorgu özeti

E-posta adresinden tahmine

GenderAPI adresin local part bölümünü analiz eder, en olası adı çıkarır ve tahminde bu adı kullanır. Kullanıcının bölgesini biliyorsanız ülke bağlamı gönderin.

01E-posta girdisimichael.smith@example.com

02İsim çıkarmaMichael

03Tahminmale · 97%

YöntemPOST

İçerik türüapplication/json

Kimlik doğrulamaBearer token

Kredi maliyeti1 sorgu

HDR

Zorunlu HTTP header'ları

Sorguyu yetkilendirin

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON sorgu gövdesi

Parametreler

Parametre	Tür	Gereklilik	Açıklama
`email`	string	Zorunlu	Analiz edilecek e-posta adresi. GenderAPI tahminden önce en olası adı çıkarır.
`country`	string	İsteğe bağlı	Bölgesel bağlam için US veya TR gibi ISO 3166-1 alpha-2 ülke kodu.
`askToAI`	boolean	İsteğe bağlı	true olduğunda çıkarılan isim veritabanında yoksa yapay zekâ desteğini kullanır.

Yapay zekâ desteği

askToAI, isim çıkarıldıktan sonra ve yalnız çıkarılan isim veritabanında bulunamadığında değerlendirilir. E-posta endpoint'i forceToGenderize kabul etmez.

Kod örnekleri

E-posta sorgusu gönderin

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":"US","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:"US",askToAI:true})
});

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":"US","askToAI":True})

200 yanıtı

Çıkarılan isim ve tahmin

JSON

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

Yanıt alanları

Alan	Tür	Açıklama
`status`	boolean	Sorgunun başarı durumu.
`used_credits`	integer	Kullanılan kredi.
`remaining_credits`	integer	Kalan kredi.
`expires`	integer	Paket bitiş UNIX timestamp değeri.
`q`	string	Gönderilen özgün e-posta.
`name`	string	E-posta adresinden çıkarılan ad.
`gender`	string \| null	male, female veya null tahmini.
`country`	string	Tahminde kullanılan ülke kodu.
`total_names`	integer	Tahmini destekleyen örnek sayısı.
`probability`	integer	Yüzde tahmin olasılığı.
`duration`	string	Sunucu işleme süresi.

Geçerli ve eksiksiz e-posta adresi kullanın

İsim çıkarma adres yapısına bağlıdır. Genel gelen kutuları, alias'lar veya tanınabilir isim içermeyen local part değerleri sonuç üretmeyebilir; tahmini kullanmadan önce name, gender veprobability alanlarını kontrol edin. E-posta sorguları saklanmaz.

Sıradaki rehber

Birden fazla e-posta adresini analiz edin

Çoklu e-posta sorgusuBir sorguda birden fazla adres işleyin →Tekli isim sorgusuBilinen adı doğrudan gönderin →