E-postadan Cinsiyet Tahmini API'si – Çoklu İstek Dokümantasyonu

Toplu istek özeti

En fazla 50 e-posta adresi işle

Bir data dizisi gönderin. GenderAPI her adresten olası adı çıkarır ve eşleşen tahmini döndürür. İsteğe bağlı id alanı, sonucu kendi veritabanınızdaki kayıtla güvenilir biçimde eşleştirmenizi sağlar.

YöntemPOST

En fazla50 e-posta

Kimlik doğrulamaBearer belirteci

Sonuç formatınames[]

50 e-posta maxİsim çıkarımıÜlkeye göre sonuçlar

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 e-posta kaydını içeren dizi.
`data[].email`	string	Gerekli	GenderAPI tarafından muhtemelen bir ilk isim çıkarılacak e-posta adresi.
`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ı	Kaydın kimliği, karşılık gelen sonuçla aynı şekilde döner.

Kayıt eşleşmesi

Her öğe için benzersiz bir id kullanın. GenderAPI bu değeri ilgili sonuçla birlikte döndürür; böylece yalnızca dizi sırasına güvenmeden doğru veritabanı kaydını güncelleyebilirsiniz.

İstek yükü

E-posta dizisini oluşturun

JSON

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

Kod örnekleri

Birden fazla e-posta isteği gönderin

cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/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": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Yanıt alanları

Alan	Tür	Açıklama
`status`	boolean	Geniş ölçekli istek başarıyla tamamlanıp tamamlanmadığını belirtir.
`used_credits`	integer	Gönderilen tüm e-postalara ait tüketilen kredi miktarı.
`remaining_credits`	integer	İstekten sonra kalan kredi miktarı.
`expires`	integer	Paketin sona erme zamanı UNIX zaman damgası olarak.
`names`	object[]	Gönderilen e-postalar için sonuçların sıralı koleksiyonu.
`names[].name`	string	E-posta adresinden çıkarılan ilk isim.
`names[].q`	string	İstekte gönderilen orijinal e-posta.
`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ı

Her adresi doğrulayın ve büyük veri kümelerini en fazla 50 kayıttan oluşan gruplara bölün. Sonucu kullanmadan önce döndürülen name ve probability alanlarını kontrol edin.

Sonraki doküman

Kullanıcı adından cinsiyeti belirle

Kullanıcı adı tek istekBir kullanıcı adından bir isim çıkar E-posta tek istekBir e-posta için AI geri dönüşü kullan →