Aller au contenu principal

API d’analyse des noms par fichier CSV

Validez le fichier CSV avant de le traiter, puis enrichissez chaque ligne avec des estimations du genre, de l’âge, de l’origine et de la langue.

URL de base​

https://api.genderrecognition.com

Format CSV​

Les fichiers CSV doivent comporter des colonnes pour le prénom et le nom. Le serveur accepte les noms de colonnes en camelCase ou en snake_case.

firstName,lastName
Alex,Morgan
Jamie,Patel

Les fichiers doivent être envoyés dans le champ file et ne pas dépasser 10 Mo.

Point de terminaison de validation​

POST /v1/voice-gender-recognition/api/csv/validate

En-têtes​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

Corps de la requête​

ChampTypeObligatoireDescription
filefileOuiFichier CSV à valider.

Exemple​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/csv/validate" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@names.csv"

Réponse​

{
  "success": true,
  "message": "CSV file validated successfully",
  "csvInfo": {
    "rowCount": 2,
    "headers": ["firstName", "lastName"],
    "sampleData": [
      {
        "firstName": "Alex",
        "lastName": "Morgan"
      }
    ]
  },
  "userInfo": {
    "remainingRequests": 2999,
    "canProcess": true
  }
}

Point de terminaison de traitement​

POST /v1/voice-gender-recognition/api/csv

En-têtes​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

Corps de la requête​

ChampTypeObligatoireDescription
filefileOuiFichier CSV à traiter.
responseFormatstringNoUtilisez csv pour recevoir un fichier CSV. Par défaut, la réponse est au format JSON.

Exemple de réponse JSON​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/csv" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@names.csv"
{
  "success": true,
  "message": "Successfully processed 2 rows",
  "data": [
    {
      "firstName": "Alex",
      "lastName": "Morgan",
      "gender": "male",
      "genderProbability": 0.86,
      "age": "25-34",
      "ageProbability": 0.78,
      "ethnicity": "English",
      "ethnicityProbability": 0.74,
      "language": "English",
      "languageProbability": 0.8
    }
  ],
  "summary": {
    "totalRows": 2,
    "processedRows": 2,
    "remainingRequests": 2997
  }
}

Exemple de réponse CSV​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/csv" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@names.csv"

Lorsque responseFormat vaut csv, l’API renvoie un fichier traité téléchargeable au format text/csv. Toute autre valeur renvoie une réponse JSON standard.

Erreurs possibles​

Clé API manquante​

{
  "error": "API key is required"
}

Clé API invalide​

{
  "error": "Invalid API key"
}

Fichier manquant​

{
  "error": "No CSV file uploaded"
}

Type de fichier invalide​

{
  "error": "Invalid file type. Only .csv format is allowed."
}

Colonnes CSV invalides​

{
  "error": "Invalid CSV format. The file must contain columns named 'firstName' or 'first_name' and 'lastName' or 'last_name'. Found columns: name"
}

Quota dépassé​

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your free tier limit of 50 requests.",
    "detailedMessage": "Insufficient remaining requests. Required: 2, Available: 0",
    "details": {
      "limit": 50,
      "used": 50,
      "reset_date": "2026-07-01T00:00:00.000Z"
    },
    "suggested_action": "Please upgrade to a premium plan to continue using the API."
  }
}

Échec du traitement​

{
  "error": "Internal server error"
}