Readability Analyzer

Analyzes text or documents using standard readability formulas to produce a detailed report on text complexity and ease of understanding.

Overview

This actor evaluates text readability, providing scores from multiple established formulas. It accepts direct text input or file uploads, processes large documents by splitting them, and outputs structured results to an Apify dataset. It's useful for content creators, educators, and developers who need to assess and improve text clarity.

Key Features

• Multi-format input: Analyze plain text or upload files (.txt, .md, .html, .pdf, .docx).
• Comprehensive scoring: Calculates a wide range of readability metrics including Flesch Reading Ease, Flesch-Kincaid Grade Level, Gunning Fog Index, SMOG Index, and more.
• Large text handling: Automatically splits and processes texts longer than 10,000 words.
• Detailed output: Provides overall scores and a sentence-level breakdown.
• Reliable execution: Includes proxy support and a retry mechanism.
• Structured storage: Results are saved in the Apify dataset and can be exported as JSON, CSV, or Excel.

How to Use

Run the actor via the Apify console. Provide input using either the textContent or fileUpload field.

Input

The actor accepts a JSON input object with the following properties:

• textContent (string, optional): The plain text to analyze.
• fileUpload (object, optional): A file upload object for supported file types. If provided, textContent is ignored.
• proxyConfiguration (object, optional): Recommended for reliable performance. Use Apify Proxy or custom proxies.

Example Input:

{
  "textContent": "Barack H. Obama is the 44th President of the United States. His story is the American story...",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output

Results are saved to the Apify dataset. The main results object contains:

results.readability

An object containing all calculated readability scores:
* fleschReadingEase
* fleschGradeLevel
* gunningFoxIndex
* smogIndex
* powersSumnerKearl
* forcastGradeLevel
* colemanLiauIndex
* automatedReadabilityIndex
* daleChallReadabilityGrade
* spacheReadabilityGrade
* linsearWriteGrade

results.sentences

An array of objects providing analysis for each sentence, including:
* phrase: The original sentence.
* cleanPhrase: The cleaned version used for analysis.
* isVeryHard: Boolean flag for high difficulty.