Temel Kullanım
GenderAPI, farklı türde giriş verileri kullanarak bir kişinin cinsiyetini belirlemenizi sağlar. Doğrudan isimleri analiz edebilir veya e-posta adresleri ve kullanıcı adlarından isim çıkarabilirsiniz. İşte nasıl başlayabileceğiniz:
1. İsimden Cinsiyet Belirleme
Aşağıdaki endpoint’e bir isim gönderin:
https://api.genderapi.io/api
Örnek:
curl "https://api.genderapi.io/api?name=Alice&key=YOUR_API_KEY"
Ayrıca isteğe bağlı parametreler ekleyebilirsiniz:
-
country: Tahmin doğruluğunu artırmak için iki harfli ülke kodu gönderin
(
ISO 3166-1 alpha-2
)
Örneğin: Türkiye için
country=TR
. -
askToAI:
true
olarak ayarlanırsa, isim veritabanında bulunamazsa API bir yapay zeka modeline cinsiyeti belirlemesi için sorar. -
forceToGenderize:
true
olarak ayarlanırsa, API gerçek insan ismi gibi görünmeyen girişler (ör. takma adlar veya sparkling unicorn veya mystic warrior gibi hayali isimler) için bile cinsiyet tahmini yapmaya çalışır. Bu, kullanıcı adlarını analiz etmek için faydalı olabilir ancak sonuçların doğruluğu daha düşük olabilir. Not: Bu parametre e-posta endpoint'inde kullanılamaz.
Parametreli örnek:
curl "https://api.genderapi.io/api?name=sparkling%20unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"
2. E-posta Adresinden Cinsiyet Belirleme
Yalnızca bir e-posta adresiniz varsa bu endpoint’i kullanın:
https://api.genderapi.io/api/email
Örnek:
curl "https://api.genderapi.io/api/email?email=alice.smith@example.com&country=TR&askToAI=true&key=YOUR_API_KEY"
Not: forceToGenderize
parametresi e-posta endpoint’i için geçerli değildir çünkü bu endpoint önce içsel olarak isim çıkarır.
3. Kullanıcı Adından Cinsiyet Belirleme
Kullanıcı adları veya takma adlar için şunu kullanın:
https://api.genderapi.io/api/username
Örnek:
curl "https://api.genderapi.io/api/username?username=sparkling_unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"
forceToGenderize
parametresi burada özellikle faydalıdır çünkü kullanıcı adları genellikle isim olmayan kelimeler veya hayali terimler içerir. Bu parametre, API'nin giriş tipik bir insan ismi olmasa bile cinsiyet tahmini yapmaya çalışmasını sağlar.
Tüm yöntemler tekli veya toplu (bulk) istekleri destekler. Daha fazla bilgi için sol taraftaki gezinme menüsündeki ilgili bölümlere bakın.
✅ API Yanıtı
Tüm endpoint’ler için JSON yanıt örneği:
{
"status": true,
"used_credits": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "michael.smith@example.com",
"name": "Michael",
"gender": "male",
"country": "US",
"total_names": 325,
"probability": 98,
"duration": "4ms"
}
Yanıt Alanları
Alan | Tip | Açıklama |
---|---|---|
status | Boolean | İstek başarılı olduysa true . false ise hata kontrolü yapın. |
used_credits | Integer | Bu istek için kullanılan kredi sayısı. |
remaining_credits | Integer | Bu istekten sonra hesabınızda kalan kredi sayısı. |
expires | Integer (timestamp) | Paketin sona erme tarihi UNIX timestamp (saniye) formatında. |
q | String | Giriş sorgunuz (isim, e-posta veya kullanıcı adı). |
name | String | Bulunan veya çıkarılan isim. |
gender | Enum[String] | Tahmin edilen cinsiyet. Olası değerler: male , female veya null . |
country | Enum[String] | En olası ülke kodu (ör. US veya DE ). |
total_names | Integer | Tahmin için kullanılan örneklerin sayısı. |
probability | Integer | Cinsiyet tahmininin olasılık yüzdesi (ör. 50-100). |
duration | String | İsteğin işlenme süresi (ör. 4ms ). |
sparkling unicorn
),
GET istekleri yapmadan önce bunları mutlaka URL encode edin. Aksi takdirde istek başarısız olabilir
veya diğer parametreler programlama diliniz ya da HTTP kütüphaneniz tarafından yanlış yorumlanabilir.
curl "https://api.genderapi.io/api?name=sparkling unicorn&key=YOUR_API_KEY"Bunun yerine şunu kullanmalısınız:
curl "https://api.genderapi.io/api?name=sparkling%20unicorn&key=YOUR_API_KEY"veya programlama dilinizde uygun URL encode fonksiyonlarını kullanın.