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. |
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 ). |