# Documentazione di GenderAPI.io V2

> Collega la tua applicazione a GenderAPI.io V2 tramite api.genderapi.io. Ottieni previsioni da nomi, indirizzi email o nomi utente, elabora batch misti e leggi i risultati insieme ai metadati su accesso e addebito.

Canonical HTML: https://www.genderapi.io/it/api-documentation

Last reviewed: 2026-09-28

## Invia la tua prima richiesta

Usa GenderAPI.io V2 per stimare il genere a partire da un nome o da un nome completo, da un indirizzo email o da un nome utente. L'origine dell'API è https://api.genderapi.io e il percorso di base di V2 è /api/v2. Prova l'esempio GET qui sotto nel browser, poi scegli una guida per collegare la tua applicazione.

La prova IP gratuita include 10 crediti per indirizzo IP nell'arco di 24 ore, condivisi con V1. Questo esempio usa solo il set di dati e costa 1 credito per richiesta, anche a ogni ricaricamento della pagina. Quando usi la tua chiave API esistente, V1 e V2 condividono lo stesso saldo dell'account.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Sofia&country=IT&ai_mode=off
```

- [Apri l'esempio GET (usa 1 credito della prova IP)](https://api.genderapi.io/api/v2/gender?type=name&value=Sofia&country=IT&ai_mode=off)
- [Configura la tua chiave API](https://www.genderapi.io/it/docs/v2/authentication#environment-setup)
- [Capire la risposta JSON](https://www.genderapi.io/it/docs/v2/responses)

## Cosa vuoi fare?

Scegli il tipo di input per esempi pronti da eseguire in cURL, JavaScript, Python, PHP, Java, C# e Go. Consulta le guide su risultati e addebiti quando sei pronto a gestire risposte reali.

- [Chiave API e prova IP](https://www.genderapi.io/it/docs/v2/authentication): Collega la tua chiave API o prova l'API gratuitamente.
- [Parametri della richiesta](https://www.genderapi.io/it/docs/v2/request-parameters): Scegli i campi di input, il contesto del paese e le opzioni della richiesta.
- [SDK ufficiali](https://www.genderapi.io/it/docs/v2/sdks): Installa un client ufficiale per il tuo linguaggio di programmazione.
- [Genere dal nome](https://www.genderapi.io/it/docs/v2/gender-from-name): Cerca un nome o un nome completo.
- [Genere dall'indirizzo email](https://www.genderapi.io/it/docs/v2/gender-from-email): Trova un indizio di nome in un indirizzo email.
- [Genere dal nome utente](https://www.genderapi.io/it/docs/v2/gender-from-username): Usa un nome utente o un nickname come input.
- [Richieste batch](https://www.genderapi.io/it/docs/v2/batch): Elabora fino a 50 nomi, indirizzi email o nomi utente in una sola volta.
- [Convalida dei numeri di telefono](https://www.genderapi.io/it/docs/v2/phone-validation): Verifica e formatta un numero di telefono.
- [Leggere una risposta](https://www.genderapi.io/it/docs/v2/responses): Leggi previsioni, valori di confidenza e risultati sconosciuti.
- [IA e nickname](https://www.genderapi.io/it/docs/v2/ai-options): Scegli quando usare l'IA e come interpretare i nickname.
- [Crediti e saldo](https://www.genderapi.io/it/docs/v2/credits-and-usage): Controlla il saldo e il costo di ogni richiesta.
- [Errori e nuovi tentativi](https://www.genderapi.io/it/docs/v2/errors-and-retries): Risolvi gli errori e valuta quando ha senso riprovare.
- [Passare da V1 a V2](https://www.genderapi.io/it/docs/v2/migration): Aggiorna un'integrazione esistente con la stessa chiave API.

## Riferimento degli endpoint

Combina https://api.genderapi.io con i percorsi assoluti di questa tabella, ad esempio https://api.genderapi.io/api/v2/gender. I parametri di query sono supportati solo con GET /gender. Per le route POST usa un corpo JSON; non inviare campi V1 come name, email, username o askToAI in una richiesta V2.

| Metodo | Percorso | Scopo |
| --- | --- | --- |
| GET | /api/v2 | Funzionalità pubbliche e limiti attuali; gratuito. |
| GET | /api/v2/openapi.json | Contratto OpenAPI canonico; gratuito. |
| GET | /api/v2/errors | Catalogo degli errori leggibile dalle macchine; gratuito. |
| GET | /api/v2/usage | Saldo attuale dell'account o della prova IP; gratuito. |
| GET / POST | /api/v2/gender | Un nome, un indirizzo email o un nome utente. |
| POST | /api/v2/gender/batch | Un batch ordinato di nomi, indirizzi email e/o nomi utente. |
| POST | /api/v2/phone/validate | Convalida e formatta un numero di telefono. |