İsimden Cinsiyet Bulma – Tekli İstek

İsimden Cinsiyet Bulma uç noktası, tek bir ismin cinsiyetini belirlemenizi sağlar. Tüm parametreler POST isteği ile JSON formatında gönderilir. Authorization başlığında Bearer token yöntemiyle kimlik doğrulaması yapmanız gerekir.

İstek URL’si

POST https://api.genderapi.io/api

Gerekli HTTP Başlıkları

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

İstek Gövdesi Parametreleri

Parametre Tip Gerekli Açıklama
name String Evet Analiz etmek istediğiniz ilk isim. Sadece bir kelime olmalı, ek unvan veya ön ek içermemelidir.
country String Hayır Tahmin doğruluğunu artırmak için iki harfli ülke kodu (ISO 3166-1 alpha-2). Örnek: Türkiye için TR.
askToAI Boolean Hayır true olarak ayarlanırsa, isim veritabanında bulunamazsa API bir yapay zekadan tahmin istemeye çalışır.
forceToGenderize Boolean Hayır true olarak ayarlanırsa, API tipik insan isimleri olmayan girdiler için bile cinsiyet tahmini yapmaya çalışır. (ör: takma adlar veya hayali isimler – sparkling unicorn gibi).

İstek Örnekleri


cURL Örneği

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"name": "Alice", "country": "US", "askToAI": true, "forceToGenderize": true}'

PHP cURL Örneği

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

$data = array(
    "name" => "Alice",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$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", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests Örneği


import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

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": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "Alice",
  "name": "Alice",
  "gender": "female",
  "country": "US",
  "total_names": 10234,
  "probability": 98,
  "duration": "4ms"
}

Yanıt Alanları

Alan Tip Açıklama
status Boolean İsteğin başarılı olup olmadığını gösterir.
used_credits Integer Bu istek için harcanan kredi sayısı.
remaining_credits Integer İstekten sonra hesabınızda kalan kredi sayısı.
expires Integer (timestamp) Paketinizin UNIX zaman damgası (timestamp) olarak bitiş tarihi.
q String Gönderdiğiniz isim (sorgu).
name String Analiz edilen veya çıkarılan isim.
gender Enum[String] Tahmin edilen cinsiyet. Olası değerler: male, female veya null.
country String Tahmin sırasında dikkate alınan ülke kodu.
total_names Integer Bu tahmin için kullanılan örnek sayısı.
probability Integer Cinsiyet tahmininin yüzde olarak güven oranı.
duration String İsteğin işlenme süresi (ör: 4ms).
Uyarı: İsim gibi giriş değerlerinin beklenmeyen karakterler içermediğinden emin olun. Eğer özel karakterler veya boşluklar kullanacaksanız, hataları önlemek için uygun JSON kodlaması yapın.