Gender API
Dili değiştir22
Giriş yapÜcretsiz başla
Menü

Geliştirici dokümantasyonu

Gender API Türkçe dokümantasyonu

Basit REST sorguları ve yapılandırılmış JSON yanıtlarıyla ad, soyad, e-posta adresi veya kullanıcı adından cinsiyet tahmini alın.

REST + JSONGET sorgularıTekli ve çokluÜlke bağlamı

Temel kullanım

İlk Gender API sorgunuzu gönderin

Tek bir değer göndererek tahmin edilen cinsiyet, probability, ülke ve kredi kullanım bilgilerini alın. Elinizdeki veriye göre isim, e-posta veya kullanıcı adı endpoint'ini seçin.

Kimlik doğrulama

API anahtarınızı key sorgu parametresiyle ekleyin. Üretim anahtarlarını sunucunuzda saklayın; tarayıcı kodunda veya herkese açık depoda paylaşmayın.

Kimlik doğrulama rehberini okuyun →
Makine tarafından okunabilir API kaynakları

Güncel GenderAPI sözleşmesini OpenAPI, Swagger veya Postman biçiminde kullanın.

OpenAPI JSONOpenAPI YAMLEtkileşimli Swagger referansını açın →Postman koleksiyonunu indirin →
GET

İsimden cinsiyet

Ad veya ad soyad sorgusu

Girdiniz bir ad ya da tam ad olduğunda temel endpoint'i kullanın.

https://api.genderapi.io/api
cURL
curl "https://api.genderapi.io/api?name=Alice&key=YOUR_API_KEY"

İsteğe bağlı parametreler

ParametreTürAçıklama
countrystringTR veya US gibi iki harfli ülke kodu.
askToAIbooleantrue olduğunda isim veritabanında bulunamazsa yapay zekâ desteğini devreye alır.
forceToGenderizebooleanİnsan adına benzemeyen sıra dışı girdiler için tahmin üretmeyi dener.
Dikkatli kullanın: Takma ad, fantastik isim veya sinyali zayıf girdilerde zorlanan tahminlerin doğruluğu daha düşük olabilir.
GET

E-postadan cinsiyet

E-posta adresi sorgusu

E-posta endpoint'i cinsiyet tahmininden önce adresteki olası adı otomatik olarak çıkarır.

https://api.genderapi.io/api/email
cURL
curl "https://api.genderapi.io/api/email?email=alice.smith%40example.com&country=TR&askToAI=true&key=YOUR_API_KEY"
forceToGenderize, isim dahili olarak çıkarıldığı için bu endpoint'te kullanılamaz.
GET

Kullanıcı adından cinsiyet

Sosyal medya kullanıcı adı

İsim içerebilecek kullanıcı adları, rumuzlar ve nickname değerleri için bu endpoint'i kullanın.

https://api.genderapi.io/api/username
cURL
curl "https://api.genderapi.io/api/username?username=sparkling_unicorn&country=US&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"

JSON yanıtı

GenderAPI yanıt alanlarını anlayın

Üç endpoint de aynı temel yanıt yapısını kullanır.

200 OK
{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "Alice",
  "name": "alice",
  "gender": "female",
  "country": "US",
  "total_names": 325,
  "probability": 98,
  "duration": "4ms"
}

Yanıt alanları

AlanTürAçıklama
statusbooleanSorgunun başarıyla tamamlanıp tamamlanmadığı.
used_creditsintegerBu sorguda kullanılan kredi miktarı.
remaining_creditsintegerSorgudan sonra kalan kredi miktarı.
expiresintegerPaket sona erme zamanının UNIX timestamp değeri.
qstringGönderilen özgün isim, e-posta veya kullanıcı adı.
namestringNormalize edilen veya girdiden çıkarılan ad.
genderstringTahmin edilen cinsiyet: male, female veya "null".
countrystringEn olası ISO 3166-1 alpha-2 ülke kodu.
total_namesintegerTahminde kullanılan isim kaydı sayısı.
probabilityintegerYüzde olarak tahmin olasılığı.
durationstringSunucudaki sorgu işleme süresi.

Girdi değerlerini her zaman URL-encode edin

Boşluklar ve özel karakterler HTTP istemciniz tarafından kodlanmalıdır. Örneğin ham boşluk yerine sparkling%20unicorn kullanın.

Entegrasyona devam edin

İş akışınıza uygun rehberi seçin

İsim sorgularıTekli ve çoklu örnekler →İstemci kütüphaneleriKullandığınız dili seçin →Hata yönetimiDurum ve hata referansı →