Kullanıcı Adından Cinsiyet Belirleme – Çoklu İstek

Multiple Username uç noktası, tek bir istekte 50 adede kadar kullanıcı adının cinsiyetini analiz etmenizi sağlar. Bu, toplu işlem ve yüksek performanslı entegrasyonlar için faydalıdır. Tüm parametreler, JSON formatında bir POST isteği ile gönderilir. İsteğinizi Authorization başlığında Bearer token yöntemiyle kimlik doğrulamanız gerekir.

API, her kullanıcı adından muhtemel bir isim çıkarmaya çalışır ve bu, cinsiyet tahmininin doğruluğunu artırabilir. Ayrıca, her kayıt için isteğe bağlı bir country filtresi ve kendi veritabanınızla eşleştirmek için özel bir id alanı gönderebilirsiniz.

Uyarı: Kullanıcı adlarının genellikle Latin karakterlerden oluşması gerekir. Ancak, sıkça gerçek isimleri temsil etmeyen kelimeler veya kombinasyonlar içerebilirler, örneğin cool_boy123.

Asıl hedefiniz doğru cinsiyet tahmini ise, forceToGenderize parametresi etkinleştirilmiş tekli istekler kullanmanızı öneririz.

Önceliğiniz yalnızca kullanıcı adlarından potansiyel isimler çıkarmaksa, bunun yerine çoklu istekler kullanılabilir.

İstek URL’si

POST https://api.genderapi.io/api/username/multi/country

Gerekli HTTP Başlıkları

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

İstek Gövdesi Parametreleri

Alan	Tip	Gerekli	Açıklama
data	Obje Dizisi	Evet	Kullanıcı adları ve isteğe bağlı parametrelerinin bulunduğu dizi. Bir istekte en fazla 50 kayıt gönderilebilir.
username	String	Evet (her obje içinde)	Analiz edilmek istenen kullanıcı adı. Alt çizgi, rakam vb. 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`.
id	String veya Integer	Hayır	Kendi veritabanınızdaki kayıtlarla sonuçları eşleştirmek için tanımlayabileceğiniz isteğe bağlı kimlik. Aynı `id`, eşleştirme amacıyla yanıtta geri döner.

Örnek İstek Gövdesi

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Örnek İstekler

cURL Örneği

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"},{"username":"giulia_rossi","country":"IT","id":"789"}]}'

PHP cURL Örneği

<?php
$url = "https://api.genderapi.io/api/username/multi/country";

$data = array(
    "data" => array(
        array(
            "username" => "anna_smith88",
            "country" => "US",
            "id" => "123"
        ),
        array(
            "username" => "michael_bauer",
            "country" => "DE",
            "id" => "456"
        ),
        array(
            "username" => "giulia_rossi",
            "country" => "IT",
            "id" => "789"
        )
    )
);

$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/multi/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    data: [
      { username: "anna_smith88", country: "US", id: "123" },
      { username: "michael_bauer", country: "DE", id: "456" },
      { username: "giulia_rossi", country: "IT", id: "789" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests Örneği

import requests

url = "https://api.genderapi.io/api/username/multi/country"

payload = {
    "data": [
        { "username": "anna_smith88", "country": "US", "id": "123" },
        { "username": "michael_bauer", "country": "DE", "id": "456" },
        { "username": "giulia_rossi", "country": "IT", "id": "789" }
    ]
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Örnek JSON Yanıtı

{
  "status": true,
  "used_credits": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    {
      "name": "Anna",
      "q": "anna_smith88",
      "gender": "female",
      "country": "US",
      "total_names": 1234,
      "probability": 92,
      "id": "123"
    },
    {
      "name": "Michael",
      "q": "michael_bauer",
      "gender": "male",
      "country": "DE",
      "total_names": 5678,
      "probability": 89,
      "id": "456"
    },
    {
      "name": "Giulia",
      "q": "giulia_rossi",
      "gender": "female",
      "country": "IT",
      "total_names": 4321,
      "probability": 95,
      "id": "789"
    }
  ],
  "duration": "5ms"
}

Yanıt Alanları

Alan	Tip	Açıklama
status	Boolean	İsteğin başarılı olup olmadığını belirtir.
used_credits	Integer	Bu istek için harcanan kredi sayısı.
remaining_credits	Integer	Bu isteğin ardından hesabınızda kalan kredi sayısı.
expires	Integer (timestamp)	Paketin sona erme tarihi, UNIX zaman damgası olarak.
names	Obje Dizisi	Her gönderilen kullanıcı adı için sonuçların listesi.
names[].name	String	Kullanıcı adından çıkarılan tespit edilen isim (varsa).
names[].q	String	Gönderdiğiniz orijinal kullanıcı adı.
names[].gender	Enum[String]	Tahmin edilen cinsiyet: `male`, `female` veya `null`.
names[].country	String	Tahmin sırasında dikkate alınan ülke kodu.
names[].total_names	Integer	Bu tahmin için kullanılan örnek sayısı.
names[].probability	Integer	Cinsiyet tahmininin doğruluk yüzdesi.
names[].id	String / Integer	İsteğinizde gönderdiğiniz aynı `id`. Kendi kayıtlarınızla eşleştirme için kullanılır.
duration	String	İsteğin işlenme süresi (ör. `5ms`).