API genere da più nomi: richieste multiple fino a 100

Panoramica della richiesta multipla

Elabora fino a 100 nomi

Invia un array data e ricevi un risultato per ogni record. Aggiungi un id del tuo sistema per ricollegare con affidabilità ogni previsione al record di origine.

MetodoPOST

Massimo100 nomi

AutenticazioneToken Bearer

Supporto AINon supportato

Le richieste multiple non usano inferenza AI.

askToAI e forceToGenderize non sono disponibili. Per nomi in alfabeti non latini o input che richiedono supporto AI, usa l’endpoint per un singolo nome.

HDR

Header HTTP obbligatori

Autorizza la richiesta multipla

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corpo JSON della richiesta

Parametri

Campo	Tipo	Requisito	Descrizione
`data`	object[]	Obbligatorio	Array contenente da 1 a 100 record di nomi.
`data[].name`	string	Obbligatorio	Nome proprio da analizzare.
`data[].country`	string	Facoltativo	Codice paese ISO 3166-1 alpha-2. Se non esiste un risultato per il paese, viene usato il risultato globale.
`data[].id`	string \| integer	Facoltativo	Identificatore del tuo record, restituito invariato per associare il risultato all’input corretto.

Fallback del paese

Se non esiste una corrispondenza per il paese indicato, GenderAPI restituisce il risultato globale disponibile. Usa codici ISO 3166-1 alpha-2 come DE, IT o US.

Payload della richiesta

Crea l’array data

JSON

{
  "data": [
    { "name": "Andrea", "country": "DE", "id": "123" },
    { "name": "andrea", "country": "IT", "id": "456" },
    { "name": "james", "country": "US", "id": "789" }
  ]
}

Esempi di codice

Invia una richiesta con più nomi

cURL

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

JavaScript

const data = [
  { name: "Andrea", country: "DE", id: "123" },
  { name: "andrea", country: "IT", id: "456" }
];

const response = await fetch("https://api.genderapi.io/api/name/multi/country", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Risposta 200

Associa i risultati ai tuoi record

JSON

{
  "status": true,
  "used_credits": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "andrea", "q": "Andrea", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "andrea", "q": "andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "duration": "5ms"
}

Campi della risposta

Campo	Tipo	Descrizione
`status`	boolean	Indica se la richiesta multipla è stata completata correttamente.
`used_credits`	integer	Crediti consumati per tutti i nomi inviati.
`remaining_credits`	integer	Crediti disponibili dopo la richiesta.
`expires`	integer	Scadenza del pacchetto come timestamp UNIX.
`names`	object[]	Elenco ordinato dei risultati di previsione.
`names[].name`	string	Nome normalizzato usato per la previsione.
`names[].q`	string	Nome originale inviato nella richiesta.
`names[].gender`	string \| null	Valore previsto: male, female oppure null.
`names[].country`	string	Codice paese considerato per il risultato.
`names[].total_names`	integer	Numero di campioni alla base del risultato.
`names[].probability`	integer	Attendibilità della previsione espressa in percentuale.
`names[].id`	string \| integer	Identificatore dell’input restituito per correlare il record.
`duration`	string	Tempo totale di elaborazione sul server.

Mantieni ogni richiesta entro 100 record

Valida l’array prima dell’invio e usa un id univoco per associare i record in modo deterministico. Dividi i dataset più grandi in gruppi di non oltre 100 nomi.

Guida successiva

Determina il genere da un’email

Richiesta singola per emailEstrai e analizza un nome dall’email →Richiesta singola per nomeUsa il supporto AI per un nome →