Określ płeć na podstawie jednego nazwiska lub nicku

Podsumowanie żądania

Z nazwy użytkownika do prawdopodobnej nazwy

GenderAPI wyszukuje sygnałów imiennych w przesłanym identyfikatorze, a następnie przewiduje płeć na podstawie danych z bazy, kontekstu krajowego oraz—w przypadku żądania—przy użyciu fallbacku AI.

Inputsparkling_unicorn

Wyodrębniony sygnałSparkling

Predictionkobieta · 92%

MethodPOST

Typ treściapplication/json

AuthenticationToken Bearer

Opcje AIAvailable

HDR

Wymagane nagłówki HTTP

Autoryzacja żądania

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Ciało żądania w formacie JSON

Parametry

Parameter	Type	Requirement	Description
`username`	string	Wymagane	Nazwa użytkownika, nazwa społeczna, imię lub nick do analizy.
`country`	string	Opcjonalne	Kod kraju ISO 3166-1 alpha-2, np. US lub TR, dla kontekstu regionalnego.
`askToAI`	boolean	Opcjonalne	Gdy jest prawda, używaj fallbacku AI, jeśli wyextractowany nazwa nie ma wyniku w bazie danych.
`forceToGenderize`	boolean	Opcjonalne	Gdy jest prawda, próbuj przewidywać aliasy lub dane wejściowe, które nie przypominają typowych nazw.

askToAI

Używaj tylko w przypadku, gdy wyeksponowany imię nie ma wyniku w bazie danych.

forceToGenderize

Zezwala na próby dla terminów fantasy, aliasów podobnych do marek oraz niezwykłych nicków.

Pewność jest istotna:Wymuszone wyniki dla słabo wyrażonych lub nieprzyjaznych dla ludzi nazw mogą być mniej wiarygodne. Ocenićprobabilityprzed podejmowaniem decyzji na podstawie przewidywania.

Przykłady kodu

Wyślij żądanie o nazwę użytkownika

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

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

Odpowiedź z kodem 200

Wyodrębniony sygnał and prediction

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

Pola odpowiedzi

Field	Type	Description
`status`	boolean	Czy żądanie zostało wykonane pomyślnie.
`used_credits`	integer	Kredyty zużyte w tym żądaniu.
`remaining_credits`	integer	Kredyty dostępne po żądaniu.
`expires`	integer	Czas wygaśnięcia pakietu w formacie UNIX timestamp.
`q`	string	Oryginalne imię użytkownika podane w żądaniu.
`name`	string	Prawdopodobne imię wyodrębnione z użytkownika.
`gender`	string \| null	Przewidywana wartość: męski, żeński lub null.
`country`	string	Kod krajowy uwzględniony w przewidywaniu.
`total_names`	integer	Liczba próbek wspierających przewidywanie.
`probability`	integer	Poziom pewności przewidywania w procentach.
`duration`	string	Czas przetwarzania przez serwer.

Traktuj nazwy użytkowników jako nieproste sygnały

Nazwa użytkownika może opisywać markę, postać lub koncept, a nie osobę. Potwierdź, że wyodrębniony sygnał jest有意义 i określ odpowiedni próg prawdopodobieństwa dla Twojego przypadku użycia.namejest sensowny i określ odpowiedni próg prawdopodobieństwa dla Twojego przypadku użycia.

Następny przewodnik

Analiza wielu nazw użytkowników

Wielokrotne żądanie nazwy użytkownikaPrzetwarzanie kilku kont w jednym żądaniu →Żądanie jednego adresu e-mailWyodrębnienie imienia z adresu e-mail →