Finn kjønn fra brukernavn

Oversikt over forespørselen

Fra brukernavn til sannsynlig navn

GenderAPI leter etter navnesignaler i det innsendte profilnavnet og predikerer deretter kjønn ved hjelp av databasegrunnlag, landkontekst og – når det er valgt – KI-reserve.

Inndatasparkling_unicorn

Uttrukket signalSparkling

Prediksjonfemale · 92%

MetodePOST

Innholdstypeapplication/json

AutentiseringBearer-token

KI-alternativerTilgjengelig

HDR

Påkrevde HTTP-headere

Autoriser forespørselen

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

JSON-body for forespørselen

Parametere

Parameter	Type	Krav	Beskrivelse
`username`	string	Påkrevd	Brukernavn, profilnavn, visningsnavn eller kallenavn som skal analyseres.
`country`	string	Valgfri	ISO 3166-1 alfa-2-landkode, for eksempel NO eller SE, for regional kontekst.
`askToAI`	boolean	Valgfri	Når verdien er true, brukes KI som reserve hvis navnet som ble hentet ut, ikke finnes i databasen.
`forceToGenderize`	boolean	Valgfri	Når verdien er true, forsøkes en prediksjon for aliaser eller inndata som ikke ligner vanlige navn.

askToAI

Bruk bare når navnet som ble hentet ut, ikke finnes i databasen.

forceToGenderize

Tillater forsøk for fantasiuttrykk, merkenavn-lignende aliaser og uvanlige kallenavn.

Konfidens er viktig: Tvungne resultater for svake eller ikke-menneskelige navnesignaler kan være mindre pålitelige. Vurderprobability før du bruker en prediksjon.

Kodeeksempler

Send en forespørsel for brukernavn

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

Uttrukket signal og prediksjon

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

Svarfelt

Felt	Type	Beskrivelse
`status`	boolean	Om forespørselen ble fullført uten feil.
`used_credits`	integer	Antall kreditter som forespørselen brukte.
`remaining_credits`	integer	Antall kreditter som er tilgjengelige etter forespørselen.
`expires`	integer	Pakkens utløpstid som UNIX-tidsstempel.
`q`	string	Det opprinnelige brukernavnet som ble sendt inn.
`name`	string	Det sannsynlige navnet som ble hentet ut fra brukernavnet.
`gender`	string \| null	Predikert verdi: male, female eller null.
`country`	string	Landkoden som ble brukt i prediksjonen.
`total_names`	integer	Antall navneforekomster som støtter prediksjonen.
`probability`	integer	Prediksjonens konfidens uttrykt i prosent.
`duration`	string	Serverens behandlingstid.

Behandle brukernavn som indirekte signaler

Et brukernavn kan beskrive et merke, en figur eller et konsept i stedet for en person. Bekreft at et uttrukket name er meningsfullt, og fastsett en akseptabel sannsynlighetsterskel for bruksområdet ditt.

Neste veiledning

Analyser flere brukernavn

Forespørsel med flere brukernavnBehandle flere profilnavn i én forespørsel →Enkeltforespørsel for e-postHent ut et navn fra en e-postadresse →