Determinare il genere da un unico nome utente o nick

Panoramica della richiesta

Dal username a un nome probabile

GenderAPI ricerca segnali di nome all'interno dell'handle inviato, poi predice il genere utilizzando prove del database, il contesto nazionale e—quando richiesto—un fallback basato sull'IA.

Inputsparkling_unicorn

Segnale estrattoSparkling

Predictionfemminile · 92%

MethodPOST

Tipo di contenutoapplication/json

AuthenticationToken Bearer

Opzioni AIAvailable

HDR

Intestazioni HTTP richieste

Autorizzare la richiesta

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corpo della richiesta JSON

Parametri

Parameter	Type	Requirement	Description
`username`	string	Obbligatorio	Nome utente, handle sociale, nome visualizzato o nick da analizzare.
`country`	string	Opzionale	Codice nazionale alpha-2 ISO 3166-1, ad esempio US o TR, per il contesto regionale.
`askToAI`	boolean	Opzionale	Quando vero, utilizza il fallback AI se il nome estratto non ha risultati nel database.
`forceToGenderize`	boolean	Opzionale	Quando vero, tenta una previsione per alias o input che non ricordano nomi tipici.

askToAI

Utilizzare solo quando il nome estratto non ha risultati nel database.

forceToGenderize

Consente tentativi per termini fantascientifici, alias simili a marchi e nicknames insoliti.

La fiducia conta:I risultati forzati per segnali di nome deboli o non umani possono essere meno affidabili. Valutareprobabilityprima di agire su una previsione.

Esempi di codice

Invia una richiesta di username

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())

Risposta 200

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

Campi della risposta

Field	Type	Description
`status`	boolean	Se la richiesta è stata completata con successo.
`used_credits`	integer	Crediti consumati da questa richiesta.
`remaining_credits`	integer	Crediti disponibili dopo la richiesta.
`expires`	integer	Tempo di scadenza del pacchetto come timestamp UNIX.
`q`	string	Nome utente originale inviato nella richiesta.
`name`	string	Nome probabile estratto dal nome utente.
`gender`	string \| null	Valore previsto: maschio, femminile o nullo.
`country`	string	Codice nazionale considerato per la previsione.
`total_names`	integer	Numero di campioni che supportano la previsione.
`probability`	integer	Confidenza della previsione espressa in percentuale.
`duration`	string	Tempo di elaborazione del server.

Trattare gli username come segnali indiretti

Un username potrebbe descrivere una marca, un personaggio o un concetto piuttosto che una persona. Confermare che un segnale estratto sia significativo e stabilire un limite di probabilità accettabile per il tuo caso d'uso.nameUn username potrebbe descrivere una marca, un personaggio o un concetto piuttosto che una persona. Confermare che un segnale estratto sia significativo e stabilire un limite di probabilità accettabile per il tuo caso d'uso.

Prossimo tutorial

Analizza più nomi utente

Richiesta multipli per nome utenteElabora diversi handle in una sola richiesta →Richiesta singola per emailEstrai un nome da un indirizzo email →