Aller au contenu
Accueil moxon

Analyse de lisibilité

L'endpoint /read analyse un texte et retourne son nombre de mots, de phrases et de syllabes, ses scores de lisibilité Flesch et un temps de lecture estimé.

posthttps://api.moxon.dev/v5/read

Comment ça marche ?

L'anglais utilise les coefficients Flesch d'origine, qui fournissent aussi un niveau scolaire Flesch-Kincaid. Le français utilise l'adaptation de Kandel & Moles, qui n'a pas d'équivalent de niveau scolaire : fleschKincaidGrade vaut donc null.

Les syllabes sont estimées par une heuristique propre à chaque langue : groupes de voyelles, moins le e final muet (e ou es en français), avec un minimum d'une syllabe par mot. Les phrases sont découpées sur ., !, ? et …, et un texte sans aucun de ces signes compte pour une seule phrase. Le temps de lecture est basé sur 200 mots par minute.

Essayerpost/v5/read
curl -X POST \  "https://api.moxon.dev/v5/read" \  -H "Content-Type: application/json" \  -d '{}'

Envoyez la requête pour voir la réponse ici.

Paramètres

Le corps de la requête doit être en JSON :

  • textstringrequis

    Texte à analyser, 50000 caractères maximum

  • lang"en" | "fr"optionnel

    Langue du texte : en ou fr. Par défaut : en

Champs de réponse

  • langstring

    Langue utilisée pour l'analyse

  • wordsnumber

    Nombre de mots — les tokens contenant au moins une lettre ou un chiffre

  • sentencesnumber

    Nombre de phrases, toujours au minimum 1

  • syllablesnumber

    Nombre total estimé de syllabes

  • fleschReadingEasenumber

    Score de lisibilité Flesch, arrondi à 2 décimales — plus il est élevé, plus le texte est facile

  • fleschKincaidGradenumber|null

    Niveau scolaire Flesch-Kincaid, arrondi à 2 décimales — null si lang vaut fr

  • readingTimestring

    Temps de lecture estimé, en secondes en dessous d'une minute (ex. 45s, 3min)

Exemples de code

Gestion des erreurs

Si les paramètres sont manquants ou invalides, l'API retournera une erreur :

  • 400Please provide a textLe paramètre text est manquant, vide, ou ne contient aucun mot
  • 400Text must be 50000 characters or fewerLe text dépasse la longueur maximale
  • 400Language must be one of: en, frLa valeur de lang n'est ni en ni fr
Modifier cette page sur GitHubSignaler un problème

Mis à jour le 7 septembre 2026