---
title: Readability Score Document Api
slug: score-readability
url: https://apyverse.com/apyhub/service/score-readability
provider: ApyHub
tags: [readability, text-analysis, content-audit, flesch-kincaid, wiener-sachtextformel, document-analysis]
auth: api_key
---

# Readability Score Document Api

What it does Readability Score scores the readability of plain text, uploaded documents, and web pages. Send it raw text, a public URL, a public document URL, or a file upload, and get back word, sentence, character, and paragraph counts plus estimated reading and speaking time. Use language to cho…

## Endpoints

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

## About

## What it does
Readability Score scores the readability of plain text, uploaded documents, and web pages. Send it raw text, a public URL, a public document URL, or a file upload, and get back word, sentence, character, and paragraph counts plus estimated reading and speaking time.

Use `language` to choose the scoring model: `english` returns Flesch-Kincaid Reading Ease, while `german` returns Wiener Sachtextformel. For each analysis, the response includes `stats` and a readability result object with `class`, `label`, `level`, `score`, and `class_label`, so you can compare content quality against a clear threshold and grade-level style label.

This is useful when you need to check whether product copy, support articles, policy pages, or marketing content is easy to read before publishing. It also fits content pipelines that automate editorial QA, accessibility checks, or internal review for long-form documents.

Readability Score works with PDF, DOC, and DOCX files, plus publicly accessible web pages and document URLs. Keep the input type aligned with the endpoint you call, and use the output to spot overly dense paragraphs, long sentences, or text that falls outside your target reading level.

## Usage

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