Toplu İsimden Cinsiyet API

Toplu sorgu özeti

100 isme kadar tek seferde işleyin

data dizisini gönderin ve her kayıt için bir sonuç alın. Her tahmini kaynak kaydınızla güvenilir biçimde eşleştirmek için sisteminizdeki id değerini ekleyin.

YöntemPOST

Maksimum100 isim

Kimlik doğrulamaBearer token

AI desteğiDesteklenmiyor

Toplu sorgular yapay zekâ çıkarımı kullanmaz.

askToAI ve forceToGenderize kullanılamaz. Latin dışı alfabelerdeki veya AI desteğine ihtiyaç duyan girdiler için tekli isim endpoint'ini kullanın.

HDR

Zorunlu HTTP header'ları

Toplu sorguyu yetkilendirin

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON sorgu gövdesi

Parametreler

Alan	Tür	Gereklilik	Açıklama
`data`	object[]	Zorunlu	1 ile 100 arasında isim kaydı içeren dizi.
`data[].name`	string	Zorunlu	Analiz edilecek ad.
`data[].country`	string	İsteğe bağlı	ISO 3166-1 alpha-2 ülke kodu. Ülkeye özel sonuç bulunamazsa global sonuç kullanılır.
`data[].id`	string \| integer	İsteğe bağlı	Sonucu kaynak kayıtla eşleştirebilmeniz için değiştirilmeden döndürülen kayıt kimliğiniz.

Ülke sonucu bulunamazsa

Gönderilen ülke için eşleşme yoksa GenderAPI mevcut global isim sonucunu döndürür. DE, IT veya US gibi ISO 3166-1 alpha-2 değerleri kullanın.

Sorgu verisi

Data dizisini oluşturun

JSON

{
  "data": [
    { "name": "Andrea", "country": "DE", "id": "123" },
    { "name": "andrea", "country": "IT", "id": "456" },
    { "name": "james", "country": "US", "id": "789" }
  ]
}

Kod örnekleri

Çoklu isim sorgusu gönderin

cURL

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

JavaScript

const data = [
  { name: "Andrea", country: "DE", id: "123" },
  { name: "andrea", country: "IT", id: "456" }
];

const response = await fetch("https://api.genderapi.io/api/name/multi/country", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

200 yanıtı

Sonuçları kendi kayıtlarınızla eşleştirin

JSON

{
  "status": true,
  "used_credits": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "andrea", "q": "Andrea", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "andrea", "q": "andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "duration": "5ms"
}

Yanıt alanları

Alan	Tür	Açıklama
`status`	boolean	Toplu sorgunun başarıyla tamamlanıp tamamlanmadığı.
`used_credits`	integer	Gönderilen isimlerin tamamında kullanılan kredi.
`remaining_credits`	integer	Sorgu sonrasında kullanılabilir kredi.
`expires`	integer	Paket bitiş zamanının UNIX timestamp değeri.
`names`	object[]	İsim tahmin sonuçlarının sıralı koleksiyonu.
`names[].name`	string	Tahmin için kullanılan normalize edilmiş isim.
`names[].q`	string	Sorguda gönderilen özgün isim.
`names[].gender`	string \| null	Tahmin edilen değer: male, female veya null.
`names[].country`	string	Bu sonuçta dikkate alınan ülke kodu.
`names[].total_names`	integer	Sonucu destekleyen örnek sayısı.
`names[].probability`	integer	Yüzde olarak tahmin olasılığı.
`names[].id`	string \| integer	Kayıt eşleştirme için geri döndürülen girdi kimliği.
`duration`	string	Toplam sunucu işleme süresi.

Her sorguyu 100 kayıtla sınırlayın

Diziyi göndermeden önce doğrulayın ve kesin kayıt eşleştirmesi için benzersiz bir id kullanın. Daha büyük veri kümelerini en fazla 100 isimlik gruplara bölün.

Sıradaki rehber

E-posta adresinden cinsiyet tahmini alın

Tekli e-posta sorgusuE-postadan isim çıkarın ve analiz edin →Tekli isim sorgusuBir isim için AI desteği kullanın →