Determina il genere da un massimo di 50 nomi utente

Panoramica della richiesta bulk

Elaborazione di fino a 50 nomi utente

Invia undataarray. GenderAPI estrae segnali potenziali di nome da ogni handle e restituisce i risultati con il tuo record opzionaleid.

MethodPOST

Maximum50 nomi utente

Authenticationtoken Bearer

opzioni AINon supportato

I risultati per nomi utente in bulk richiedono una revisione attenta.

Gli handle possono contenere marchi, termini fantastici o parole non correlate. I richiesti in bulk non sono accettatiaskToAI or forceToGenderize. Per un trattamento più sicuro di input anomali, utilizzare ilsingolo richiesta.

HDR

Intestazioni HTTP richieste

Autorizza la richiesta in bulk

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corpo della richiesta JSON

Parametri

Field	Type	Requirement	Description
`data`	object[]	Richiesto	Array contenente da 1 a 50 record di username.
`data[].username`	string	Richiesto	Username o handle da analizzare; sono supportati gli underscore e i numeri.
`data[].country`	string	Opzionale	Codice alpha-2 ISO 3166-1 utilizzato come contesto regionale.
`data[].id`	string \| integer	Opzionale	Il tuo identificativo, restituito senza modifiche insieme al risultato corrispondente.

Guida all'input

I nomi utente a caratteri latini forniscono in generale segnali di nome più chiari. Utilizzare valori unici e valutare quelli estrattiidprima di aggiornare i record.name and probabilityRichiesta del payload

Richiesta del payload

Costruire l'array degli utenti

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Esempi di codice

Invia una richiesta con più nomi utente

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Risposta 200

Nomi estratti e predizioni

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

Campi della risposta

Field	Type	Description
`status`	boolean	Se il richiesta in bulk è stata eseguita con successo.
`used_credits`	integer	Crediti consumati per gli utenti inseriti.
`remaining_credits`	integer	Crediti disponibili dopo il richiesta.
`expires`	integer	Scadenza del pacchetto in formato UNIX timestamp.
`names`	object[]	Risultati per gli utenti inseriti.
`names[].name`	string	Nome potenziale estratto dall'utente.
`names[].q`	string	Nome utente originale inserito nella richiesta.
`names[].gender`	string \| null	Valore previsto: maschio, femminile o null.
`names[].country`	string	Codice nazionale considerato per questo risultato.
`names[].total_names`	integer	Numero di campioni che supportano questo risultato.
`names[].probability`	integer	Confidenza della previsione espressa in percentuale.
`names[].id`	string \| integer	Identificatore di input restituito per la correlazione del record.
`duration`	string	Tempo totale di elaborazione del server.

Mantenere ogni richiesta entro 50 record

Dividere gli input più grandi in batch. Un nome utente è un segnale indiretto, quindi verificare il nome estratto e stabilire un limite di probabilità accettabile prima di applicare i risultati.

Riferimento successivo

Validare e formattare i numeri di telefono

Validazione del numero di telefonoVerificare e revisionare i metodi di validazione e formattazione →Username singolo richiestaUse opzioni AI for one handle →