Bepalen van geslacht op basis van één gebruikersnaam of nicknaam

Overzicht van de aanvraag

Van gebruikersnaam naar waarschijnlijke naam

GenderAPI zoekt naar naamsignalen in de ingediende handle, voorspelt dan de geslachtsidentiteit op basis van databasegegevens, landcontext en—indien gevraagd—AI-fallback.

Inputsparkling_unicorn

Gehaald signalSparkling

Predictionvrouwelijk · 92%

MethodPOST

Inhoudstypeapplication/json

AuthenticationBearer token

AI-optiesAvailable

HDR

Verplichte HTTP-header

Autoriseer de aanvraag

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON request body

Parameters

Parameter	Type	Requirement	Description
`username`	string	Verplicht	Gebruikersnaam, sociale handle, weergave naam of nickname om te analyseren.
`country`	string	Optioneel	ISO 3166-1 alpha-2 landcode, zoals US of TR, voor regionale context.
`askToAI`	boolean	Optioneel	Wanneer true, gebruik een AI-valtback als de geextraheerde naam geen resultaat in de database heeft.
`forceToGenderize`	boolean	Optioneel	Wanneer true, probeer een voorspelling voor aliasen of invoer die niet overeenkomen met typische namen.

askToAI

Gebruik alleen wanneer de geextraheerde naam geen resultaat in de database heeft.

forceToGenderize

Sta pogingen toe voor fantasie-terms, merksoortige aliasen en ongebruikelijke nicknames.

Vertrouwen is belangrijk:Verplichte resultaten voor zwakke of niet-menselijke naamsignalen kunnen minder betrouwbaar zijn. Beoordeelprobabilityvooractie op een voorspelling.

Codevoorbeelden

Een gebruikersnaam aanvragen

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 antwoord

Gehaald 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"
}

Antwoordvelden

Field	Type	Description
`status`	boolean	Of de aanvraag succesvol is afgerond.
`used_credits`	integer	Credits verbruikt door deze aanvraag.
`remaining_credits`	integer	Credits beschikbaar na de aanvraag.
`expires`	integer	Verloopdatum van de pakketten als UNIX-timestamp.
`q`	string	Oorspronkelijk gebruikersnaam die in de aanvraag is ingevoerd.
`name`	string	Waarschijnlijk naam die is geëxtraheerd uit de gebruikersnaam.
`gender`	string \| null	Geprediceerde waarde: man, vrouw of null.
`country`	string	Landcode die is overwogen voor de prediking.
`total_names`	integer	Aantal voorbeelden die de prediking ondersteunen.
`probability`	integer	Vertraging van de prediking in procenten.
`duration`	string	Verwerkingstijd van de server.

Gebruikersnamen behandelen als indirecte signalen

Een gebruikersnaam kan een merk, karakter of concept beschrijven in plaats van een persoon. Bevestig dat het gehaald is betekenisvol en stel een acceptabele waarschijnlijkheidsdrempel in voor uw gebruikssituatie.nameis betekenisvol en stel een acceptabele waarschijnlijkheidsdrempel in voor uw gebruikssituatie.

Volgende handleiding

Meerdere gebruikersnamen analyseren

Meerdere gebruikersnamen in één aanvraagMeerdere handles verwerken in één aanvraag →E-mail één aanvraagEen naam extraheren uit een e-mailadres →