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).
Uyarı: Giriş değerlerinizde boşluk veya özel karakterler varsa (ör. 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.