Kullanıcı Adından Cinsiyet Tahmini API'si

Toplu istek özeti

En fazla 50 kullanıcı adı işle

Bir data dizisi gönderin. GenderAPI her kullanıcı adından olası isim sinyallerini çıkarır ve sonuçları isteğe bağlı id alanıyla birlikte döndürür.

YöntemPOST

En fazla50 kullanıcı adı

Kimlik doğrulamaBearer belirteci

AI seçenekleriDesteklenmiyor

Büyük kullanıcı adı sonuçları dikkatli incelemelere ihtiyaç duyar.

Kullanıcı adları marka, kurgusal ifade veya ilgisiz sözcükler içerebilir. Toplu endpointaskToAI ve forceToGenderize seçeneklerini kabul etmez. Belirsiz girdileri daha kontrollü işlemek için tekli istek endpoint'ini kullanın.

HDR

Gerekli HTTP başlıkları

Toplu isteği yetkilendirin

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON istek gövdesi

Parametreler

Alan	Tür	Gereklilik	Açıklama
`data`	object[]	Gerekli	1 ile 50 arasında kullanıcı adı kayıtlarını içeren dizi.
`data[].username`	string	Gerekli	Analiz edilecek kullanıcı adı veya hesap; alt çizgiler ve rakamlar desteklenir.
`data[].country`	string	İsteğe bağlı	Yerel bağlam olarak kullanılan ISO 3166-1 alpha-2 ülke kodu.
`data[].id`	string \| integer	İsteğe bağlı	Kendi kimliğinizi, sonuçla birlikte aynı şekilde döndürürüz.

Girdi rehberliği

Latin karakterli kullanıcı adları genellikle daha açık isim sinyalleri sağlar. Her kayıt için benzersiz birid kullanın; verilerinizi güncellemeden önce döndürülen name veprobability alanlarını değerlendirin.

İstek yükü

Kullanıcı adı dizisini oluşturun

JSON

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

Kod örnekleri

Birden fazla kullanıcı adı isteği gönderin

cURL

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"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await 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 })
});

200 yanıt

Çıkarılan isimler ve tahminler

JSON

{
  "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" }
  ], "duration": "5ms"
}

Cevap alanları

Alan	Tür	Açıklama
`status`	boolean	Genel istekin başarıyla tamamlanıp tamamlanmadığını gösterir.
`used_credits`	integer	Gönderilen kullanıcı adlarına ait harcamış kredi miktarı.
`remaining_credits`	integer	İstekten sonra kalan kredi miktarı.
`expires`	integer	Paketin sona erme zamanı UNIX zaman damgası olarak.
`names`	object[]	Gönderilen kullanıcı adlarına ait sonuçlar.
`names[].name`	string	Kullanıcı adından çıkarılan potansiyel isim.
`names[].q`	string	İstekte gönderilen orijinal kullanıcı adı.
`names[].gender`	string \| null	Tahmin edilen değer: erkek, kadın veya boş.
`names[].country`	string	Bu sonucu için dikkate alınan ülke kodu.
`names[].total_names`	integer	Bu sonucu destekleyen örnek sayısı.
`names[].probability`	integer	Tahmin güvenliği yüzdelik olarak.
`names[].id`	string \| integer	Kaydın korelasyonu için döndürülen giriş kimliği.
`duration`	string	Sunucu işleme süresi toplamı.

Her istek 50 kayıttan fazla olmamalı

Daha büyük girdileri en fazla 50 kayıttan oluşan gruplara bölün. Kullanıcı adı dolaylı bir sinyal olduğu için çıkarılan ismi doğrulayın ve sonucu kullanmadan önce kabul edilebilir bir olasılık eşiği belirleyin.

Sonraki doküman

Telefon numaralarını doğrulayın ve biçimlendirin

Telefon doğrulamaDoğrulama ve biçimlendirme yöntemlerini inceleyin →Kullanıcı adı — tekli istekTek bir kullanıcı adı için AI seçeneklerini kullanın →