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=OnurPrzykładowa odpowiedź V2. Wyślij zapytanie, aby zobaczyć wynik na żywo.
{
"data": {
"input": {
"type": "name",
"value": "Onur",
"country": null
},
"name": "onur",
"gender": "male",
"country": "TR",
"confidence": 0.9,
"confidence_kind": "observed_frequency",
"sample_count": 100,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "onur",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "11111111-1111-4111-8111-111111111111",
"duration_ms": 12,
"access": {
"mode": "ip_trial",
"reason": "api_key_missing"
},
"usage": {
"charged_credits": 1,
"remaining_credits": 9,
"billing_status": "confirmed",
"resets_at": "2026-09-26T12:00:00.000Z",
"limit": 10,
"period_seconds": 86400
}
}
}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.