GenderAPI.io · REST API v2
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.
GenderAPI.io V2
https://api.genderapi.io/api/v2/gender?type=name&value=ZofiaPrawdziwa odpowiedź V2 pobrana 1 października 2026 r. Wyślij zapytanie, aby zobaczyć wynik na żywo.
| Imię | Zofia |
|---|---|
| Płeć | Kobieta |
| Pewność | 99,1% |
| Kraj | Polska (PL) |
| Źródło | Baza imion |
| Zużyte kredyty | 1 |
{
"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
}
}
}Analiza imion oraz imion i nazwisk
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.
Płeć na podstawie imienia
Otrzymasz oszacowanie wraz ze wskaźnikiem pewności i źródłem prognozy. Gdy prognoza nie jest dostępna, V2 wyraźnie to sygnalizuje.
Płeć na podstawie adresu 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.
Płeć na podstawie nazwy użytkownika
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.
Przetwarzanie plików Excel i CSV
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.
Integracje GenderAPI.io
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.
Najczęstsze pytania
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 pytaniaGenderAPI.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ę.
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.
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.
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.
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.
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.
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.
Rozpocznij integrację
Załóż konto, przetestuj pierwsze zapytania z 200 bezpłatnymi kredytami dziennie i przetwarzaj pliki Excel lub CSV, gdy będzie to potrzebne.