Ottenere il Genere da Username - Richiesta Multipla

L’endpoint Multiple Username ti permette di analizzare il genere di fino a 50 username in una singola richiesta. È utile per elaborazioni in bulk e integrazioni ad alte prestazioni. Tutti i parametri vengono inviati tramite una richiesta POST in formato JSON. Devi autenticarti usando il metodo Bearer token nell’header Authorization.

L’API proverà a estrarre un nome proprio probabile da ciascuno username, il che può aiutare a migliorare la previsione del genere. Puoi anche inviare un filtro opzionale country e un campo personalizzato id per ogni record, per associare i risultati al tuo database.

Attenzione: Gli username solitamente devono essere in caratteri latini. Tuttavia, spesso contengono parole o combinazioni che non rappresentano veri nomi, ad esempio cool_boy123.

Se il tuo obiettivo principale è una previsione accurata del genere, consigliamo di utilizzare richieste singole con il parametro forceToGenderize attivo.

Se invece la tua priorità è semplicemente estrarre possibili nomi dagli username, puoi utilizzare le richieste multiple.

URL della Richiesta

POST https://api.genderapi.io/api/username/multi/country

Header HTTP Obbligatori

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

Parametri del Corpo della Richiesta

Campo Tipo Obbligatorio Descrizione
data Array di oggetti Sì Array di username e dei relativi parametri opzionali. Massimo 50 elementi per richiesta.
username String Sì (all’interno di ciascun oggetto) Lo username da analizzare. Può includere underscore, numeri, ecc.
country String No Codice paese a due lettere (ISO 3166-1 alpha-2) per migliorare la precisione della previsione. Esempio: TR per la Turchia.
id String o Integer No ID opzionale definito da te per associare i risultati ai tuoi record di database. Lo stesso id sarà restituito nella risposta per scopi di mapping.

Esempio di Corpo della Richiesta

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

Esempi di Richieste


Esempio 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"},{"username":"giulia_rossi","country":"IT","id":"789"}]}'

Esempio PHP cURL

<?php
$url = "https://api.genderapi.io/api/username/multi/country";

$data = array(
    "data" => array(
        array(
            "username" => "anna_smith88",
            "country" => "US",
            "id" => "123"
        ),
        array(
            "username" => "michael_bauer",
            "country" => "DE",
            "id" => "456"
        ),
        array(
            "username" => "giulia_rossi",
            "country" => "IT",
            "id" => "789"
        )
    )
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization": "Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Esempio JavaScript fetch

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: [
      { username: "anna_smith88", country: "US", id: "123" },
      { username: "michael_bauer", country: "DE", id: "456" },
      { username: "giulia_rossi", country: "IT", id: "789" }
    ]
  })
})
.then(response => response.json())
.then(data => console.log(data));

Esempio Python requests

import requests

url = "https://api.genderapi.io/api/username/multi/country"

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

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Esempio di Risposta 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"
    },
    {
      "name": "Giulia",
      "q": "giulia_rossi",
      "gender": "female",
      "country": "IT",
      "total_names": 4321,
      "probability": 95,
      "id": "789"
    }
  ],
  "duration": "5ms"
}

Campi di Risposta

Campo Tipo Descrizione
status Boolean Indica se la richiesta è andata a buon fine.
used_credits Integer Numero di crediti utilizzati per questa richiesta.
remaining_credits Integer Crediti rimanenti nel tuo account dopo questa richiesta.
expires Integer (timestamp) Data di scadenza del pacchetto come timestamp UNIX.
names Array di oggetti Lista dei risultati per ciascuno username inviato.
names[].name String Il nome rilevato, se presente, estratto dallo username.
names[].q String Lo username originale che hai inviato nella richiesta.
names[].gender Enum[String] Genere previsto: male, female o null.
names[].country String Codice paese considerato durante la previsione.
names[].total_names Integer Numero di campioni utilizzati per questa previsione.
names[].probability Integer Percentuale di confidenza nella previsione del genere.
names[].id String / Integer Lo stesso id inviato nella richiesta, usato per associare i tuoi record.
duration String Tempo totale di elaborazione della richiesta (es. 5ms).