Tunnista sukupuoli käyttäjänimestä

Pyynnön yleiskatsaus

Käyttäjänimestä todennäköiseksi nimeksi

GenderAPI etsii lähetetystä profiilinimestä nimisignaaleja ja ennustaa sukupuolen tietokannan, maakontekstin ja valinnaisen tekoälyvarmistuksen avulla.

Syöteemilia_k

Poimittu signaaliEmilia

Ennustefemale · 99%

MenetelmäPOST

Sisältötyyppiapplication/json

TunnistautuminenBearer-token

TekoälyasetuksetKäytettävissä

HDR

Pakolliset HTTP-headerit

Valtuuta pyyntö

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Pyynnön JSON-runko

Parametrit

Parametri	Tyyppi	Vaatimus	Kuvaus
`username`	string	Pakollinen	Analysoitava käyttäjänimi, profiilinimi, näyttönimi tai lempinimi.
`country`	string	Valinnainen	Alueellista kontekstia varten ISO 3166-1 alpha-2 -maakoodi, kuten FI tai SE.
`askToAI`	boolean	Valinnainen	Kun arvo on true, tekoälyä käytetään varamenetelmänä, jos poimittua nimeä ei löydy tietokannasta.
`forceToGenderize`	boolean	Valinnainen	Kun arvo on true, ennustetta yritetään myös aliaksille ja syötteille, jotka eivät muistuta tavallisia nimiä.

askToAI

Käytä vain, kun poimittua nimeä ei löydy tietokannasta.

forceToGenderize

Sallii ennusteyrityksen mielikuvitusilmauksille, brändimäisille aliaksille ja epätavallisille lempinimille.

Luottamusarvolla on merkitystä: Pakotetut tulokset heikoille tai muuta kuin henkilönimeä muistuttaville signaaleille voivat olla epäluotettavampia. Arvioi probability ennen ennusteen käyttöä.

Koodiesimerkit

Lähetä käyttäjänimikysely

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"emilia_k","country":"FI","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: "emilia_k", country: "FI", askToAI: true, forceToGenderize: true })
});

Python

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

200-vastaus

Poimittu signaali ja ennuste

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "emilia_k",
  "name": "Emilia", "gender": "female", "country": "FI",
  "total_names": 9876, "probability": 99, "duration": "6ms"
}

Vastauskentät

Kenttä	Tyyppi	Kuvaus
`status`	boolean	Suoritettiinko pyyntö ilman virheitä.
`used_credits`	integer	Pyynnön käyttämien krediittien määrä.
`remaining_credits`	integer	Pyynnön jälkeen käytettävissä olevat krediitit.
`expires`	integer	Paketin vanhenemisaika UNIX-aikaleimana.
`q`	string	Pyynnössä lähetetty alkuperäinen käyttäjänimi.
`name`	string	Käyttäjänimestä poimittu todennäköinen nimi.
`gender`	string \| null	Ennustettu arvo: male, female tai null.
`country`	string	Ennusteessa käytetty maakoodi.
`total_names`	integer	Ennustetta tukevien nimiesiintymien määrä.
`probability`	integer	Ennusteen luottamus prosentteina.
`duration`	string	Palvelimen käsittelyaika.

Käsittele käyttäjänimiä epäsuorina signaaleina

Käyttäjänimi voi kuvata henkilön sijasta brändiä, hahmoa tai käsitettä. Varmista, että poimittu name on merkityksellinen, ja määritä käyttötarkoitukseesi sopiva hyväksyttävä todennäköisyysraja.

Seuraava opas

Analysoi useita käyttäjänimiä

Usean käyttäjänimen kyselyKäsittele useita profiilinimiä yhdellä kyselyllä →Sähköpostin yksittäinen kyselyPoimi nimi sähköpostiosoitteesta →