E-posta ile Cinsiyet Belirleme – Çoklu İstek

Multiple Email uç noktası, tek bir istekte 50'ye kadar e-posta adresinin cinsiyet analizini yapmanıza olanak tanır. Bu, toplu işleme ve yüksek performanslı entegrasyonlar için kullanışlıdır. Tüm parametreler, JSON olarak bir POST isteğiyle gönderilir. Authorization başlığında Bearer token yöntemiyle kimlik doğrulama yapmalısınız.

API, her e-posta adresinden muhtemel bir ilk adı çıkarır ve her biri için cinsiyeti belirler. Ayrıca, sonuçları kendi veritabanınızdaki kayıtlarla eşleştirmek için her kayıt için isteğe bağlı country filtresi ve özel bir id alanı gönderebilirsiniz.

İstek URL'si

POST https://api.genderapi.io/api/email/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 Nesne Dizisi Evet E-postalar ve isteğe bağlı parametrelerinin dizisi. Her istek için maksimum 50 kayıt.
email String Evet (her nesnede) Analiz edilecek e-posta adresi. API, muhtemel ilk adı çıkarır.
country String Hayır Tahminin doğruluğunu artırmak için iki harfli ülke kodu (ISO 3166-1 alpha-2). Örnek: Türkiye için TR.
id String veya Integer Hayır Sonuçları kendi veritabanınızda eşleştirmek için tanımlayabileceğiniz isteğe bağlı kimlik. Aynı id yanıt olarak geri dönecektir.

İstek Gövdesi Örneği

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

İstek Örnekleri


cURL Örneği

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":"andrea.rossi@example.it","country":"IT","id":"456"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

PHP cURL Örneği

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

$data = array(
    "data" => array(
        array(
            "email" => "andrea.schmidt@example.com",
            "country" => "DE",
            "id" => "123"
        ),
        array(
            "email" => "andrea.rossi@example.it",
            "country" => "IT",
            "id" => "456"
        ),
        array(
            "email" => "james.brown@example.com",
            "country" => "US",
            "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/email/multi/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    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" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests Örneği

import requests

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

payload = {
    "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" }
    ]
}

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": 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": "Andrea",
      "q": "andrea.rossi@example.it",
      "gender": "male",
      "country": "IT",
      "total_names": 13537,
      "probability": 98,
      "id": "456"
    },
    {
      "name": "James",
      "q": "james.brown@example.com",
      "gender": "male",
      "country": "US",
      "total_names": 45274,
      "probability": 100,
      "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 kullanılan kredi sayısı.
remaining_credits Integer İstekten sonra hesabınızda kalan kredi sayısı.
expires Integer (timestamp) Paketin UNIX timestamp olarak bitiş tarihi.
names Nesne dizisi Her gönderilen e-posta için sonuçların listesi.
names[].name String E-postadan çıkarılan ilk ad.
names[].q String Gönderdiğiniz orijinal e-posta.
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 Tahminin güven olasılığı yüzdesi.
names[].id String / Integer İstekle gönderdiğiniz id; kendi verinizle eşleştirmek için kullanılır.
duration String İsteğin toplam işlenme süresi (ör. 5ms).