# API płci dla imion, adresów e-mail i nazw użytkowników

> Oszacuj prawdopodobną płeć na podstawie imienia, pełnego imienia i nazwiska, adresu e-mail lub nazwy użytkownika. GenderAPI.io V2 zwraca uporządkowany JSON ze źródłem prognozy, wskaźnikiem pewności i opcjonalnym kontekstem kraju.

Canonical HTML: https://www.genderapi.io/pl

Last reviewed: 2026-09-28

## Informacje ogólne

Oszacuj prawdopodobną płeć na podstawie imienia, pełnego imienia i nazwiska, adresu e-mail lub nazwy użytkownika. GenderAPI.io V2 zwraca uporządkowany JSON ze źródłem prognozy, wskaźnikiem pewności i opcjonalnym kontekstem kraju.

## Przetestuj zapytanie V2 dla imienia

Każde zapytanie kosztuje 1 kredyt. Jeśli nie zapisano klucza lub nie został on rozpoznany, używana jest próba obejmująca 10 kredytów na 24 godziny, wspólnych dla adresu IP.

Prawdziwa odpowiedź V2 pobrana 1 października 2026 r. Wyślij zapytanie, aby zobaczyć wynik na żywo.

**Reprezentatywna odpowiedź; nie jest to wynik zapytania na żywo**

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "Zofia",
      "country": null
    },
    "name": "zofia",
    "gender": "female",
    "country": "PL",
    "confidence": 0.9910714285714286,
    "confidence_kind": "observed_frequency",
    "sample_count": 112,
    "source": "dataset",
    "result_status": "identified",
    "reason": null,
    "country_source": "dataset",
    "match": {
      "name": "zofia",
      "method": "normalized",
      "scope": "global",
      "country": null
    }
  },
  "meta": {
    "request_id": "41cd4a32-f464-42d4-8d9b-c9c86f2c64d1",
    "duration_ms": 13,
    "access": {
      "mode": "api_key",
      "reason": null
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 49999,
      "billing_status": "confirmed",
      "resets_at": null,
      "limit": null,
      "period_seconds": null
    }
  }
}
```

- [Otwórz demo na żywo na stronie HTML](https://www.genderapi.io/pl#name-demo)

## API płci stworzone dla imion z całego świata

Sprawdzaj pojedyncze rekordy, wysyłaj partie albo korzystaj z naszych narzędzi do arkuszy kalkulacyjnych. V2 odróżnia wyniki z prognozą od wyników bez prognozy, dzięki czemu Twoja aplikacja zachowuje niepewność zamiast wymuszać oszacowanie.

Pokrycie zależy od imienia i kraju: Cały świat

Wskaźnik pewności wraz ze źródłem i sposobem interpretacji: 0–1

Wyniki i zużycie kredytów w formacie JSON: V2

Rekordów w partii z kluczem API; 10 w próbie dla adresu IP: 50

## Określaj płeć na podstawie imienia lub imienia i nazwiska

Otrzymasz oszacowanie wraz ze wskaźnikiem pewności i źródłem prognozy. Gdy prognoza nie jest dostępna, V2 wyraźnie to sygnalizuje.

- Same imiona oraz imiona z nazwiskami

- Opcjonalny kontekst kraju, jeśli jest znany

- Imiona zapisane alfabetem łacińskim i innymi systemami pisma

- [Zobacz API V2 dla imion →](https://www.genderapi.io/pl/docs/v2/gender-from-name)

## Wykorzystaj sygnały imienia zawarte w adresie e-mail

Analizuj sygnały imienia w popularnych formatach adresów e-mail. Dodawaj oszacowanie i jego źródło do rekordów CRM, leadów i analiz.

- Adresy prywatne i firmowe

- Wzbogacanie rekordów CRM

- Pewność i źródło w odpowiedzi

- [Zobacz API V2 dla adresów e-mail →](https://www.genderapi.io/pl/docs/v2/gender-from-email)

## Analizuj nazwy użytkowników i pseudonimy

Wyszukuj rozpoznawalne imiona w nazwach użytkowników. Opcja forceToGenderize pozwala podjąć próbę oszacowania także dla pseudonimów, które nie zawierają prawdziwego imienia; nie gwarantuje jednak uzyskania prognozy.

- Użytkownicy serwisów społecznościowych i społeczności internetowych

- Opcjonalna analiza pseudonimów

- Wyraźny status, gdy brak prognozy

- [Zobacz API V2 dla nazw użytkowników →](https://www.genderapi.io/pl/docs/v2/gender-from-username)

## Przetwarzaj listy imion w partiach

Prześlij plik Excel lub CSV, wybierz kolumnę źródłową i pobierz wyniki. Aby wysyłać partie z własnej aplikacji, skorzystaj z przewodnika po zapytaniach zbiorczych V2.

- Pliki Excel i CSV

- Kolumny z imionami, imionami i nazwiskami lub adresami e-mail

- Opcjonalny kontekst kraju

- [Zobacz przewodnik po partiach V2 →](https://www.genderapi.io/pl/docs/v2/batch)

## Zintegruj API lub połącz gotowe narzędzia

Zacznij od REST API albo połącz GenderAPI.io z arkuszami kalkulacyjnymi, platformami e-commerce i narzędziami automatyzacji. W każdym przewodniku sprawdź, z której wersji API korzysta dana integracja.

- [Zobacz wszystkie integracje](https://www.genderapi.io/pl/integrations)

## Co warto wiedzieć przed rozpoczęciem

Poznaj rodzaje zapytań, wskaźnik pewności, bezpłatny dostęp i koszt w kredytach. Formaty zapytań i przykłady kodu znajdziesz w dokumentacji V2.

- [Zobacz wszystkie pytania →](https://www.genderapi.io/pl/frequently-asked-questions)

### Czym jest GenderAPI.io?

GenderAPI.io szacuje prawdopodobną płeć na podstawie imienia, adresu e-mail lub nazwy użytkownika. V2 zwraca prognozę, pewność, źródło i zużycie kredytów w formacie JSON. Są to oszacowania oparte na wzorcach imion; nie weryfikują one tożsamości płciowej deklarowanej przez daną osobę.

### Kiedy V2 korzysta ze sztucznej inteligencji?

Pojedyncze zapytanie najpierw sprawdza zbiór danych. Jeśli nie znajdzie w nim prognozy, domyślnie korzysta z AI. Ten standardowy tryb, łącznie z użyciem AI, kosztuje w sumie 1 kredyt. W zapytaniach zbiorczych AI jest domyślnie wyłączona. Możesz wybrać tryb AI lub włączyć forceToGenderize, aby analizować pseudonimy.

### Jak interpretować pewność i wyniki bez prognozy?

Pole confidence w V2 zawiera wartość od 0 do 1 albo null. Pole confidence_kind odróżnia częstotliwość zaobserwowaną w zbiorze danych od pewności zgłoszonej przez model; wskaźnik ten nie gwarantuje poprawności wyniku. Gdy brak prognozy, odpowiedź zawiera gender: null i result_status: unknown.

### Ile kredytów kosztuje jedno zapytanie?

Standardowe zapytanie V2 kosztuje 1 kredyt, również wtedy, gdy użyto AI, oraz wtedy, gdy pomyślnie przetworzony wynik nie zawiera prognozy. Tryb AI always kosztuje 2 kredyty. Z opcją forceToGenderize prognoza ze zbioru danych kosztuje 1 kredyt; jeśli zostanie użyta AI, łączny koszt wynosi 2 kredyty. W zapytaniach zbiorczych koszt jest liczony osobno dla każdego rekordu.

### Czy mogę wysłać wiele rekordów w jednym zapytaniu?

Tak. V2 przyjmuje do 50 rekordów w partii z ważnym kluczem API albo do 10 w próbie dla adresu IP. Jedno zapytanie HTTP może więc zużyć wiele kredytów. Większe pliki możesz przetwarzać także za pomocą narzędzi Excel i CSV lub innych integracji.

### Czy mogę wypróbować API bezpłatnie?

Bez klucza API demo V2 korzysta z próby obejmującej 10 kredytów na 24 godziny, wspólnych dla wszystkich osób korzystających z tego samego adresu IP. Bezpłatne konto otrzymuje 200 kredytów dziennie. Są to limity kredytów, a nie stała liczba zapytań: tryby kosztujące 2 kredyty szybciej wyczerpują saldo.

### Czy mój obecny klucz API działa z V2?

Tak. V1 i V2 korzystają z tego samego klucza API i tego samego salda konta. Istniejące integracje V1 pozostają dostępne. Nowe integracje opieraj na dokumentacji V2, ponieważ jej endpointy, pola odpowiedzi i format błędów różnią się od V1.

## Wypróbuj GenderAPI.io bezpłatnie

Załóż konto, przetestuj pierwsze zapytania z 200 bezpłatnymi kredytami dziennie i przetwarzaj pliki Excel lub CSV, gdy będzie to potrzebne.

- [Utwórz konto](https://app.genderapi.io/user/register)
- [Czytaj dokumentację](https://www.genderapi.io/pl/api-documentation)
