Docs · SEO
Readability scoring
Six standard readability formulas plus reading time. No fetch — you supply the text.
POST
/v1/seo/readability Scores the supplied text with Flesch Reading Ease, Flesch-Kincaid Grade Level, Gunning-Fog, SMOG, Automated Readability Index (ARI), and Coleman-Liau. Returns word count, sentence count, syllable count, and a reading-time estimate at 200 words per minute. Includes a plain-English summary band ("plain English", "fairly difficult", etc.) mapped from Flesch Reading Ease. Pure transform via the textstat library — no network call.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| text | string | yes | — | Text to score. Minimum 5 words. Body limit 1 MB. |
Request
curl -X POST https://api.qcrawl.com/v1/seo/readability \
-H "Authorization: Bearer osk_..." \
-d '{"text": "Qcrawl returns clean structured data from any URL. Send a URL, pick a format, get back markdown, HTML, plain text, or links."}'Response
{
"status": "success",
"word_count": 24,
"sentence_count": 2,
"syllable_count": 33,
"reading_time_min": 1,
"scores": {
"flesch_reading_ease": 76.22,
"flesch_kincaid_grade": 5.4,
"gunning_fog": 6.5,
"smog_index": 5.4,
"automated_readability_index": 7.1,
"coleman_liau_index": 5.6
},
"summary": {"band": "fairly_easy", "label": "7th-grade level; fairly easy."}
}Errors
| Code | Meaning |
|---|---|
| 400 | text is empty or fewer than 5 words. |