---
title: Readability Scores Documents API
slug: score-readability
url: https://apyhub.com/apyhub/service/score-readability
provider: ApyHub
categories: [Artificial Intelligence, SEO]
tags: [documents, score, readability]
auth: api_key
---

# Readability Scores Documents API

Analyze documents or web pages for readability scores, text stats, and grade-level classification. Useful for content review and plain-language checks.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/extract/document/readability-score/file` | What it does Uploads a document file and returns readability metrics for the extracted text. The re… | 250 |
| POST | `/extract/document/readability-score/url` | What it does Scores the readability of a publicly accessible web page fetched from the provided fil… | 250 |

## About

## What it does
Readability Score analyzes a document or web page and returns text statistics plus a readability score you can use to gauge how easy the content is to read.

Send a PDF, DOC, or DOCX file to `POST /file`, or a publicly accessible web page URL to `POST /file_url`. In both cases, you can set `language` to `english` or `german`. The response includes `stats` such as `words`, `sentences`, `characters`, `paragraphs`, `reading_time`, `speaking_time`, `avg_word_length`, `avg_sentence_length`, and `avg_paragraph_length`.

For document analysis, the service returns `flesh_kincaid_reading_ease` with a `class`, `label`, `level`, `score`, and `class_label`. For web page analysis, it returns `wiener_sachtextformel` with the same fields. That makes it useful for content review pipelines, editorial QA, and checking whether customer-facing copy matches a target reading level before publishing.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/score-readability