---
title: "Analyze Readability"
method: GET
path: "/api/v1/readability"
tags: ["Analysis"]
---

# Analyze Readability

`GET /api/v1/readability`

## Request

- Base URL: `https://llmse.ai`
- URL: `https://llmse.ai/api/v1/readability`
- Auth: one of:
  - none
  - HTTP bearer

Analyzes content readability using Flesch Reading Ease. Returns score (0-100), grade (A-F), Flesch-Kincaid grade level, estimated reading time, and word/sentence statistics. Web content should target grade A (60+ Flesch score) for broad accessibility.

## Query parameters

- `url` string, uri, required

## Response `200`

Readability analysis result

- ReadabilityResult: Content readability analysis using Flesch Reading Ease. Grade thresholds: A>=60 (easy/web-friendly), B>=50, C>=30, D>=10, F<10.
  - `url` string: The analyzed URL
  - `cached` boolean
  - `score` number, required: Flesch Reading Ease score (0-100, higher = easier). Rounded to 1 decimal place.
  - `grade` 'A' | 'B' | 'C' | 'D' | 'F', required
  - `flesch_kincaid_grade_level` number, required: US school grade level equivalent. Rounded to 1 decimal place.
  - `reading_time_minutes` number, required: Estimated reading time in minutes
  - `word_count` integer, required: Total word count
  - `sentence_count` integer, required: Total sentence count
  - `difficult_words` integer, required: Count of difficult/uncommon words

## Other responses

- `400`: Invalid request
- `429`: Rate limited

---

[API](https://skmtc.dev/llmse/apis/llmse-api.md) · [All operations](https://skmtc.dev/llmse/apis/llmse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/llmse/apis/llmse-api/revisions/8aedf67208e4?raw)