Kullanıcı Adına Göre Cinsiyet Belirleme – Tekli İstek
Get Gender by Username uç noktası, bir kullanıcı adı veya takma ad
analiz edilerek kişinin cinsiyetini belirlemenizi sağlar. Tüm parametreler
JSON formatında POST isteği ile gönderilir. Authorization başlığında Bearer token yöntemiyle
kimlik doğrulaması yapmanız gerekir.
İstek URL'si
POST https://api.genderapi.io/api/username
Gerekli HTTP Başlıkları
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
İstek Gövdesi Parametreleri
Parametre |
Tür |
Gerekli |
Açıklama |
username |
String |
Evet |
Analiz edilecek kullanıcı adı veya takma ad. Sosyal medya kullanıcı adı,
ekran adı veya takma ad olabilir. Gerçek isim olmayan kelimeler,
örneğin fantastik terimler veya marka isimleri içerebilir.
|
country |
String |
Hayır |
Tahmin doğruluğunu artırmak için iki harfli ülke kodu
(ISO 3166-1 alpha-2).
Örneğin Türkiye için TR .
|
askToAI |
Boolean |
Hayır |
true olarak ayarlanırsa, API veritabanında bulunmayan isimler için
yapay zeka modelinden cinsiyet tahmini yapmasını ister.
|
forceToGenderize |
Boolean |
Hayır |
true olarak ayarlanırsa, API gerçek insan isimlerine benzemeyen
kullanıcı adları için bile cinsiyet tahmin etmeye çalışır
(ör. sparkling_unicorn gibi fantastik terimler veya takma adlar).
|
İstek Örnekleri
cURL Örneği
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}'
PHP cURL Örneği
<?php
$url = "https://api.genderapi.io/api/username";
$data = array(
"username" => "sparkling_unicorn",
"country" => "US",
"askToAI" => true,
"forceToGenderize" => true
);
$payload = json_encode($data);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
"Content-Type: application/json",
"Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
JavaScript fetch Örneği
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
})
})
.then(response => response.json())
.then(data => console.log(data));
Python requests Örneği
import requests
url = "https://api.genderapi.io/api/username"
payload = {
"username": "sparkling_unicorn",
"country": "US",
"askToAI": True,
"forceToGenderize": True
}
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
JSON Yanıt Örneği
{
"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"
}
Yanıt Alanları
Alan |
Tür |
Açıklama |
status |
Boolean |
İsteğin başarılı olup olmadığını belirtir. |
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) |
Paketinizin UNIX zaman damgası olarak sona erme tarihi. |
q |
String |
Gönderdiğiniz giriş sorgusu (kullanıcı adı). |
name |
String |
Kullanıcı adından çıkarılan isim. |
gender |
Enum[String] |
Tahmin edilen cinsiyet. Olası değerler: male , female veya null . |
country |
String |
Tahmin sırasında dikkate alınan ülke kodu. |
total_names |
Integer |
Bu tahmin için kullanılan örnek sayısı. |
probability |
Integer |
Cinsiyet tahmininin doğruluk yüzdesi. |
duration |
String |
İsteğin işlenme süresi (ör. 6ms ). |