Kullanıcı Adından Cinsiyet Tahmini API'si – Tekli İstek Dokümantasyonu

İstek genel bilgisi

Kullanıcı adından olası isme

GenderAPI, gönderilen kullanıcı adındaki isim sinyallerini arar; veritabanı kanıtlarını, ülke bağlamını ve istendiğinde AI geri dönüşünü kullanarak tahmin üretir.

Girdisparkling_unicorn

Çıkarılan işaretSparkling

Tahminkadın · 92%

YöntemPOST

İçerik türüapplication/json

Kimlik doğrulamaBearer belirteci

AI seçenekleriKullanılabilir

HDR

Gerekli HTTP başlıkları

İsteği yetkilendirin

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON istek gövdesi

Parametreler

Parametre	Tür	Gereklilik	Açıklama
`username`	string	Gerekli	Analiz edilecek kullanıcı adı, sosyal hesap, görüntüleme adı ya da nick ismi.
`country`	string	İsteğe bağlı	Yerel bağlam için ISO 3166-1 alpha-2 ülke kodu, örneğin US veya TR gibi.
`askToAI`	boolean	İsteğe bağlı	Eğer doğruysa, çıkarılan ismin veri tabanında sonucu yoksa AI yerine geçmesini denetler.
`forceToGenderize`	boolean	İsteğe bağlı	Eğer doğruysa, normal isimlere benzemeyen eşleşmeler veya girişler için tahmin yapmaya çalışır.

askToAI

Yalnızca çıkarılan isim için veritabanında sonuç bulunamadığında kullanılır.

forceToGenderize

Kurgusal ifadeler, markaya benzeyen kullanıcı adları ve nadir takma adlar için tahmin denenmesine izin verir.

Güvenlik önemlidir:Zayıf veya insan olmayan isim sinyalleri için zorla sonuçlar daha az güvenilir. Etkiprobabilityöncesi bir tahmin üzerine hareket etmeyi değerlendirin.

Kod örnekleri

Kullanıcı adı isteği gönder

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

200 cevabı

Çıkarılan sinyal ve tahmin

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

Cevap alanları

Alan	Tür	Açıklama
`status`	boolean	İstek başarıyla tamamlanmış mı.
`used_credits`	integer	Bu istek tarafından tüketilen kredi sayısı.
`remaining_credits`	integer	İstekten sonra mevcut kredi sayısı.
`expires`	integer	Paketin sona erme zamanı UNIX zaman damgası olarak.
`q`	string	İstekte verilen orijinal kullanıcı adı.
`name`	string	Kullanıcı adından muhtemelen çıkarılan isim.
`gender`	string \| null	Tahmin edilen değer: erkek, kadın veya boş.
`country`	string	Tahmin için dikkate alınan ülke kodu.
`total_names`	integer	Tahmini destekleyen örnek sayısı.
`probability`	integer	Tahmin güvenilirliği yüzdelik olarak.
`duration`	string	Sunucu işlenme süresi.

Kullanıcı adlarını dolaylı sinyaller olarak ele al

Bir kullanıcı adı bir markayı, karakteri veya kavramı temsil edebilir; gerçek bir kişiye ait olmayabilir. Döndürülenname değerinin anlamlı olduğunu doğrulayın ve kullanım senaryonuz için kabul edilebilir bir olasılık eşiği belirleyin.

Sonraki doküman

Birden fazla kullanıcı adı analiz et

Kullanıcı adı çoklu istekBir istekte birden fazla hesap işleyin →E-posta tek istekE-postadan bir isim çıkarın →