İsimden Cinsiyet API | Tekli Sorgu Rehberi

Sorgu özeti

Her sorguda bir isim gönderin

Bir ad içeren JSON nesnesini Bearer token ile doğrulayarak gönderin. Bölgesel isim örüntülerinin tahmini iyileştirebileceği durumlarda ülke kodu ekleyin.

YöntemPOST

İçerik türüapplication/json

Kimlik doğrulamaBearer token

Kredi maliyeti1 sorgu

HDR

Zorunlu HTTP header'ları

Sorguyu yetkilendirin

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

API anahtarınızı sunucu ortam değişkenlerinde saklayın. Kimlik bilgisi güvenliği için kimlik doğrulama rehberini inceleyin.

JSON sorgu gövdesi

Parametreler

Parametre	Tür	Gereklilik	Açıklama
`name`	string	Zorunlu	Analiz edilecek ad. Unvan veya ön ek olmadan temiz bir isim değeri gönderin.
`country`	string	İsteğe bağlı	Bölgesel bağlam için US veya TR gibi ISO 3166-1 alpha-2 ülke kodu.
`askToAI`	boolean	İsteğe bağlı	true olduğunda isim veritabanında bulunamazsa yapay zekâ desteğini kullanır.
`forceToGenderize`	boolean	İsteğe bağlı	true olduğunda tipik bir isme benzemeyen girdiler veya takma adlar için sonuç üretmeyi dener.

Yapay zekâ desteği hakkında

askToAI yalnız veritabanında sonuç bulunamadığında uygulanır. Sıra dışı girdiler için zorlanan tahminler daha az güvenilir olabilir; bu nedenle probability değerini önemli bir sinyal olarak değerlendirin.

Kod örnekleri

Tekli isim sorgusu gönderin

Aşağıdaki örneklerin tamamı aynı sorguyu Bearer doğrulamasıyla gönderir.

cURL

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}'

JavaScript

const response = await 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 })
});

const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"name": "Alice", "country": "US", "askToAI": True}
)
print(response.json())

200 yanıtı

Cinsiyet tahmini sonucu

JSON

{
  "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	Tür	Açıklama
`status`	boolean	Sorgunun başarıyla tamamlanıp tamamlanmadığı.
`used_credits`	integer	Bu sorguda kullanılan kredi.
`remaining_credits`	integer	Sorgu sonrasında kullanılabilir kredi.
`expires`	integer	Paket bitiş zamanının UNIX timestamp değeri.
`q`	string	Sorguda gönderilen özgün isim.
`name`	string	GenderAPI tarafından analiz edilen isim.
`gender`	string \| null	Tahmin edilen değer: male, female veya null.
`country`	string	Tahminde dikkate alınan ülke kodu.
`total_names`	integer	Tahmini destekleyen örnek sayısı.
`probability`	integer	Yüzde olarak tahmin olasılığı.
`duration`	string	Sunucudaki sorgu işleme süresi.

Temiz ve doğru kodlanmış girdi gönderin

Unvan veya ön ek olmadan bir ad kullanın. JSON istemcileri kodlamayı otomatik yapar; yine de sorgu gövdesini oluşturmadan önce dış girdiyi doğrulayın.

Sıradaki rehber

Birden fazla ismi analiz edin

Çoklu isim sorgusuBir sorguda birden fazla isim işleyin →Kimlik doğrulamaAPI anahtarı güvenliğini inceleyin →