Bestäm kön från ett användarnamn eller nicknamn

Begäran översikt

Från användarnamn till troligt namn

GenderAPI letar efter namnsignaler inom den överförda hanteringen, sedan förutsäger den kön med hjälp av databasbevis, landsspecifika kontext och—om det krävs—AI-fallbädd.

Inputsparkling_unicorn

Extraherad signalSparkling

Predictionkvinna · 92%

MethodPOST

Innehållstypapplication/json

AuthenticationBärar-token

AI-valAvailable

HDR

Krävda HTTP-huvud

Autentikation av begäran

Content-Typeapplication/json

AuthorizationBearer DINNA_API_NYCKEL

JSON begäran i kroppen

Parametrar

Parameter	Type	Requirement	Description
`username`	string	Obligatorisk	Användarnamn, social profil, visningsnamn eller nicknamn att analysera.
`country`	string	Valfritt	ISO 3166-1 alpha-2 landkod, t.ex. US eller TR, för regionell kontext.
`askToAI`	boolean	Valfritt	När true används AI-fallbädd om det extraherade namnet inte hittar ett resultat i databasen.
`forceToGenderize`	boolean	Valfritt	När true försöker en förutsägelse för alias eller inmatningar som inte liknar vanliga namn.

askToAI

Använd endast när det extraherade namnet inte finns i databasen.

forceToGenderize

Tillåter försök för fantasitermer, marknadsföringsliknande alias och ovanliga nicknamn.

Försiktighet är avgörande:Tvingade resultat för svaga eller icke-mänskliga namnsignaler kan vara mindre tillförlitliga. Utvärderaprobabilityinnan du agerar på en förutsägelse.

Kodexempel

Skicka en användarnamnfråga

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())

200 svar

Extraherad signal 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"
}

Svarsfält

Field	Type	Description
`status`	boolean	Om begäran slutfördes framgångsrikt.
`used_credits`	integer	Krediterna som förbrukades av denna begäran.
`remaining_credits`	integer	Krediterna som är kvar efter begäran.
`expires`	integer	Paketets utgångstid som en UNIX-tidstämpel.
`q`	string	Originalanvändarnamn som skickades i begäran.
`name`	string	Sannolikt namn extraherat från användarnamnet.
`gender`	string \| null	Förutsägda värde: man, kvinna eller null.
`country`	string	Landkod som övervägdes vid förutsägelsen.
`total_names`	integer	Antal exempel som stödjer förutsägelsen.
`probability`	integer	Förutsägelsekonfidentiitet uttryckt i procent.
`duration`	string	Serverbehandlingstid.

Tillämpa användarnamn som osynliga signaler

Ett användarnamn kan beskriva en marknadsplats, karaktär eller koncept istället för en person. Bekräfta att en extraherad signal är meningsfull och fastställ en acceptabel sannolikhetsgräns för din användning.nameEn extraherad signal är meningsfull och fastställ en acceptabel sannolikhetsgräns för din användning.

Nästa guide

Analys av flera användarnamn

Användarnamn i flera begäranBehandla flera profiler i en begäran →E-post i en begäranExtrahera ett namn från en e-post →