Určení pohlaví z uživatelského jména API

Přehled požadavku

Od uživatelského jména k pravděpodobnému jménu

GenderAPI hledá ve vstupu signály jména a poté odhaduje pohlaví podle databázových údajů, kontextu země a na vyžádání také pomocí AI.

Vstuptereza_novakova

Extrahovaný signálTereza

Odhadfemale · 97%

MetodaPOST

Typ obsahuapplication/json

AutentizaceBearer token

Možnosti AIDostupné

HDR

Povinné HTTP hlavičky

Autorizujte požadavek

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Tělo požadavku JSON

Parametry

Parametr	Typ	Požadavek	Popis
`username`	string	Povinné	Uživatelské jméno, profilový název, přezdívka nebo alias k analýze.
`country`	string	Volitelné	Kód země ISO 3166-1 alpha-2, například CZ nebo US, pro regionální kontext.
`askToAI`	boolean	Volitelné	Při hodnotě true použije podporu AI, pokud extrahované jméno nemá výsledek v databázi.
`forceToGenderize`	boolean	Volitelné	Při hodnotě true se pokusí o odhad také u aliasů nebo vstupů, které nepřipomínají běžná jména.

askToAI

Použijte, pokud extrahované jméno nemá výsledek v databázi.

forceToGenderize

Umožní zkusit odhad u fantazijních výrazů, aliasů připomínajících značku a neobvyklých přezdívek.

Spolehlivost je důležitá: Vynucené výsledky pro slabé nebo neosobní signály mohou být méně přesné. Před použitím odhadu vyhodnoťte hodnotu probability.

Ukázky kódu

Odešlete požadavek s uživatelským jménem

cURL

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

Python

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

Odpověď 200

Extrahovaný signál a odhad

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "tereza_novakova",
  "name": "Tereza", "gender": "female", "country": "CZ",
  "total_names": 9876, "probability": 97, "duration": "6ms"
}

Pole odpovědi

Pole	Typ	Popis
`status`	boolean	Určuje, zda byl požadavek úspěšně zpracován.
`used_credits`	integer	Počet kreditů spotřebovaných požadavkem.
`remaining_credits`	integer	Počet kreditů dostupných po požadavku.
`expires`	integer	Čas vypršení balíčku jako časové razítko UNIX.
`q`	string	Původní uživatelské jméno odeslané v požadavku.
`name`	string	Pravděpodobné jméno extrahované z uživatelského jména.
`gender`	string \| null	Odhadovaná hodnota: male, female nebo null.
`country`	string	Kód země zohledněný při odhadu.
`total_names`	integer	Počet vzorků podporujících odhad.
`probability`	integer	Míra spolehlivosti odhadu v procentech.
`duration`	string	Doba zpracování na serveru.

Uživatelská jména berte jako nepřímý signál

Uživatelské jméno může označovat značku, postavu nebo pojem místo člověka. Ověřte, že extrahované name dává smysl, a stanovte pro svůj případ použití přijatelnou hranici pravděpodobnosti.

Další průvodce

Analyzujte více uživatelských jmen

Hromadný požadavek pro uživatelská jménaZpracujte několik profilových názvů najednou →Jednotlivý požadavek pro e-mailExtrahujte jméno z e-mailu →