# GenderAPI.io V2 dokümantasyonu

> İlk isteğinizi gönderin, uygulamanızı bağlayın ve sonuçları yorumlayın. Bir isim, e-posta adresi veya kullanıcı adıyla başlayın.

Canonical HTML: https://www.genderapi.io/tr/api-documentation

Last reviewed: 2026-09-27

## İlk isteğinizi gönderin

Bir isim, e-posta adresi veya kullanıcı adı göndererek JSON biçiminde cinsiyet tahmini alın. Aşağıdaki adresi API anahtarı olmadan tarayıcınızda deneyin; ardından uygulamanıza uygun rehberi seçin.

Ücretsiz deneme, IP adresi başına 24 saatte 10 kredi sağlar ve V1 ile ortaktır. Yalnızca veri kümesini kullanan bu örnek, sayfa yenilemeleri dahil her istekte 1 kredi tüketir. Mevcut API anahtarınızı bağladığınızda V1 ve V2 aynı hesap bakiyesini kullanır.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Emre&country=TR&ai_mode=off
```

- [GET örneğini aç (1 deneme kredisi kullanır)](https://api.genderapi.io/api/v2/gender?type=name&value=Emre&country=TR&ai_mode=off)
- [API anahtarınızı ayarlayın](https://www.genderapi.io/tr/docs/v2/authentication#environment-setup)
- [JSON yanıtını anlayın](https://www.genderapi.io/tr/docs/v2/responses)

## Ne yapmak istiyorsunuz?

Girdi türünüzü seçerek cURL, JavaScript, Python, PHP, Java, C# ve Go örneklerine ulaşın. Gerçek yanıtları işlerken sonuç ve ücretlendirme rehberlerini inceleyin.

- [API anahtarı ve ücretsiz deneme](https://www.genderapi.io/tr/docs/v2/authentication): API anahtarınızı bağlayın veya API’yi ücretsiz deneyin.
- [İstek parametreleri](https://www.genderapi.io/tr/docs/v2/request-parameters): Girdi alanlarını, ülke bilgisini ve istek seçeneklerini belirleyin.
- [Resmi SDK'lar](https://www.genderapi.io/tr/docs/v2/sdks): Programlama diliniz için resmi bir istemci kurun.
- [İsimden cinsiyet tahmini](https://www.genderapi.io/tr/docs/v2/gender-from-name): Bir ad veya tam ad ile sorgulama yapın.
- [E-postadan cinsiyet tahmini](https://www.genderapi.io/tr/docs/v2/gender-from-email): E-posta adresindeki isim ipuçlarını değerlendirin.
- [Kullanıcı adından cinsiyet tahmini](https://www.genderapi.io/tr/docs/v2/gender-from-username): Kullanıcı adı veya takma ad ile sorgulama yapın.
- [Toplu sorgular (batch)](https://www.genderapi.io/tr/docs/v2/batch): Hesap anahtarıyla en fazla 50, IP denemesinde 10 isim, e-posta veya kullanıcı adını tek istekte işleyin.
- [Telefon doğrulama](https://www.genderapi.io/tr/docs/v2/phone-validation): Telefon numarasını kontrol edin ve biçimlendirin.
- [Yanıtı yorumlama](https://www.genderapi.io/tr/docs/v2/responses): Tahminleri, güven skorlarını ve belirsiz sonuçları yorumlayın.
- [Yapay zekâ ve takma adlar](https://www.genderapi.io/tr/docs/v2/ai-options): Yapay zekânın ne zaman kullanılacağını ve takma adların nasıl işleneceğini seçin.
- [Krediler ve bakiye](https://www.genderapi.io/tr/docs/v2/credits-and-usage): Bakiyenizi ve her isteğin kredi maliyetini kontrol edin.
- [Hatalar ve yeniden denemeler](https://www.genderapi.io/tr/docs/v2/errors-and-retries): Hataları giderin ve ne zaman yeniden deneyeceğinize karar verin.
- [V1’den geçiş](https://www.genderapi.io/tr/docs/v2/migration): Mevcut entegrasyonunuzu aynı API anahtarıyla güncelleyin.

## Uç nokta referansı

Tablodaki mutlak yolları https://api.genderapi.io adresine ekleyin. Örnek: https://api.genderapi.io/api/v2/gender. Sorgu parametreleri yalnızca GET /gender için desteklenir. POST isteklerinde JSON gövdesi kullanın; V2 isteğine V1’deki name, email, username veya askToAI alanlarını göndermeyin.

| Yöntem | Yol | Amaç |
| --- | --- | --- |
| GET | /api/v2 | Desteklenen özellikler ve güncel sınırlar; ücretsiz. |
| GET | /api/v2/openapi.json | Esas OpenAPI sözleşmesi; ücretsiz. |
| GET | /api/v2/errors | Makine tarafından okunabilir hata kataloğu; ücretsiz. |
| GET | /api/v2/usage | Güncel hesap veya deneme bakiyesi; ücretsiz. |
| GET / POST | /api/v2/gender | Tek isim, e-posta adresi veya kullanıcı adı. |
| POST | /api/v2/gender/batch | Sırası korunan isim, e-posta ve/veya kullanıcı adı toplu sorgusu. |
| POST | /api/v2/phone/validate | Telefon numarasını doğrular ve biçimlendirir. |