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).