# Documentation de GenderAPI.io V2

> Connectez votre application à GenderAPI.io V2 sur api.genderapi.io. Analysez des prénoms, des adresses e-mail ou des noms d'utilisateur, traitez des lots mixtes et interprétez les résultats avec les métadonnées d'accès et de facturation.

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

Last reviewed: 2026-09-28

## Envoyez votre première requête

Utilisez GenderAPI.io V2 pour estimer le genre à partir d'un prénom, d'un nom complet, d'une adresse e-mail ou d'un nom d'utilisateur. L'origine de l'API est https://api.genderapi.io et le chemin de base de la V2 est /api/v2. Essayez l'exemple GET ci-dessous dans votre navigateur, puis choisissez un guide pour connecter votre application.

L'essai gratuit comprend 10 crédits par adresse IP toutes les 24 heures, partagés avec la V1. Cet exemple, limité au jeu de données, consomme 1 crédit à chaque requête, y compris à chaque actualisation de la page. Lorsque vous utilisez votre clé API existante, la V1 et la V2 débitent le même solde de compte.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Léa&country=FR&ai_mode=off
```

- [Ouvrir l'exemple GET (consomme 1 crédit d'essai)](https://api.genderapi.io/api/v2/gender?type=name&value=L%C3%A9a&country=FR&ai_mode=off)
- [Configurez votre clé API](https://www.genderapi.io/fr/docs/v2/authentication#environment-setup)
- [Comprendre la réponse JSON](https://www.genderapi.io/fr/docs/v2/responses)

## Que souhaitez-vous faire ?

Choisissez votre type d'entrée pour obtenir des exemples fonctionnels en cURL, JavaScript, Python, PHP, Java, C# et Go. Consultez les guides sur les résultats et la facturation lorsque vous êtes prêt à traiter des réponses réelles.

- [Clé API et essai gratuit](https://www.genderapi.io/fr/docs/v2/authentication): Connectez votre clé API ou essayez l'API gratuitement.
- [Paramètres de requête](https://www.genderapi.io/fr/docs/v2/request-parameters): Choisissez les champs d'entrée, le contexte de pays et les options de requête.
- [SDK officiels](https://www.genderapi.io/fr/docs/v2/sdks): Installez un client officiel pour votre langage de programmation.
- [Genre à partir d'un nom](https://www.genderapi.io/fr/docs/v2/gender-from-name): Recherchez un prénom ou un nom complet.
- [Genre à partir d'une adresse e-mail](https://www.genderapi.io/fr/docs/v2/gender-from-email): Repérez un indice de nom dans une adresse e-mail.
- [Genre à partir d'un nom d'utilisateur](https://www.genderapi.io/fr/docs/v2/gender-from-username): Utilisez un nom d'utilisateur ou un surnom comme entrée.
- [Requêtes par lots](https://www.genderapi.io/fr/docs/v2/batch): Traitez jusqu'à 50 éléments avec une clé API, ou 10 avec l'essai par IP.
- [Validation de numéros de téléphone](https://www.genderapi.io/fr/docs/v2/phone-validation): Vérifiez et formatez un numéro de téléphone.
- [Lire une réponse](https://www.genderapi.io/fr/docs/v2/responses): Lisez les prédictions, les scores de confiance et les résultats inconnus.
- [IA et surnoms](https://www.genderapi.io/fr/docs/v2/ai-options): Choisissez quand utiliser l'IA et comment gérer les surnoms.
- [Crédits et solde](https://www.genderapi.io/fr/docs/v2/credits-and-usage): Consultez votre solde et le coût de chaque requête.
- [Erreurs et nouvelles tentatives](https://www.genderapi.io/fr/docs/v2/errors-and-retries): Résolvez les erreurs et décidez quand réessayer.
- [Migrer depuis la V1](https://www.genderapi.io/fr/docs/v2/migration): Mettez à jour une intégration existante à l'aide de la même clé API.

## Référence des points de terminaison

Combinez https://api.genderapi.io avec les chemins absolus de ce tableau, par exemple https://api.genderapi.io/api/v2/gender. Les paramètres de requête ne sont pris en charge que sur GET /gender. Utilisez des corps JSON pour les routes POST ; n'envoyez pas de champs V1 tels que name, email, username ou askToAI dans une requête V2.

| Méthode | Chemin | Rôle |
| --- | --- | --- |
| GET | /api/v2 | Capacités publiques et limites actuelles ; gratuit. |
| GET | /api/v2/openapi.json | Contrat canonique OpenAPI ; gratuit. |
| GET | /api/v2/errors | Catalogue d'erreurs lisible par machine ; gratuit. |
| GET | /api/v2/usage | Solde actuel du compte ou de l'essai par IP ; gratuit. |
| GET / POST | /api/v2/gender | Un nom, une adresse e-mail ou un nom d'utilisateur. |
| POST | /api/v2/gender/batch | Un lot ordonné de noms, d'adresses e-mail et/ou de noms d'utilisateur. |
| POST | /api/v2/phone/validate | Valider et formater un numéro de téléphone. |