Afgør køn fra et enkelt brugernavn eller nicknavn

Forespørgselsøversigt

Fra brugernavn til sandsynligt navn

GenderAPI søger efter navnindikatorer i den indsendte handle, og forudsiger køn ved hjælp af databasebevis, landssammenhæng og—hvis det anmodes—AI-fald tilbage.

Inputsparkling_unicorn

Extracted signalSparkling

Predictionkvinde · 92%

MethodPOST

Indholdstypeapplication/json

AuthenticationBearer-token

AI-mulighederAvailable

HDR

Obligatoriske HTTP-hovedfelter

Autoriser den forespørgsel

Content-Typeapplication/json

AuthorizationBearer DIN_API_NYT

JSON-anmodningstekst

Parametre

Parameter	Type	Requirement	Description
`username`	string	Påkrævet	Brugernavn, sociale profiler, visningsnavn eller nicknavn til at analysere.
`country`	string	Valgfrit	ISO 3166-1 alpha-2-landkode, som f.eks. US eller TR, for regional kontekst.
`askToAI`	boolean	Valgfrit	Når true, bruges AI-fald til at udtrække navn, hvis der ikke findes resultat i databasen.
`forceToGenderize`	boolean	Valgfrit	Når true, forsøges en forudseelse for aliaser eller indtastninger, der ikke ligner typiske navne.

askToAI

Brug kun, når det ekstraherede navn har ingen databaseresultat.

forceToGenderize

Tillader forsøg med fiktionelle termer, markedsføringssædvanlige aliaser og uvanlige nicknavne.

Konfidens er afgørende:Forstærkede resultater for svage eller ikke-menneskelige navn-tilsignaler kan være mindre tilfældige. Vurderprobabilityinden man agerer på en forudsigelse.

Kodeeksempler

Send en brugernavn-anmodning

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

Udtøjet signal og forudsigelse

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

Svarfelter

Field	Type	Description
`status`	boolean	Om forespørgslen blev udført succesfuldt.
`used_credits`	integer	Kreditter, der er brugt af denne forespørgsel.
`remaining_credits`	integer	Kreditter, der er tilgængelige efter forespørgslen.
`expires`	integer	Pakkeudgået tid som UNIX-tidstamp.
`q`	string	Original brugernavn, der blev indsendt i forespørgslen.
`name`	string	Mulig navn, der blev ekstraheret fra brugernavnet.
`gender`	string \| null	Forudsagt værdi: mand, kvinde eller null.
`country`	string	Landskode, der blev overvejet i forudsigelsen.
`total_names`	integer	Antallet af eksempler, der støtter forudsigelsen.
`probability`	integer	Forudsigelseskonfidens som procent.
`duration`	string	Serverbehandlingstid.

Treat brugernavn som ikke direkte signaler

Et brugernavn kan beskrive en markedsplads, karakter eller koncept i stedet for en person. Bekræft, at et udtøjet er betydning og opstil en acceptabel sandsynlighedsgrense for din brugssituation.nameEt brugernavn kan beskrive en markedsplads, karakter eller koncept i stedet for en person. Bekræft, at et udtøjet er betydning og opstil en acceptabel sandsynlighedsgrense for din brugssituation.

Næste vejledning

Analyser flere brugernavne

Brugernavne i flere forespørgslerBehandling af flere profiler i én forespørgsel →E-mail forespørgsel for en brugerExtract et navn fra en e-mail →