Readability Scores Documents API
250 atoms
Base tier
About
This Utility API calculates the readability score of pdf and document files. A readability score is a number that tells you how easy it will be for someone to read a particular piece of text.
The ApyHub readability assessment API simplifies text evaluation with features like comprehensive readability scores, grade level insights for precise audience targeting, and additional metrics for linguistic complexity. Troubleshooting is made efficient through clear error codes and messages in the API response.
This Utility API is ideal for different use cases:. Content creators can tailor marketing content and materials for optimal audience comprehension. Educators can benefit from this Utility API by aligning educational materials with students' cognitive abilities, fostering engaging learning experiences. Researchers can also find value in improving the accessibility of research papers, ensuring complex findings are understandable to a diverse readership.
Select API Endpoints
Input
API Playground
API Documentation
Extract Readability Score from File
POST
https://api.apyhub.com/extract/document/readability-score/file
Request example
Method:
POST
Content Type:
multipart/form-data
Request Body
Attribute | Type | Mandatory | Description |
---|---|---|---|
file | File | Yes | The source pdf or document file should be in .pdf ,.doc or .docx format for which you want to calculate the readability score metics. |
Response
Attribute | Type | Description |
---|---|---|
data.flesh_kincaid_reading_ease.score | Number | The Flesch Reading Ease score ranges from 1 to 100, The Flesh Kincaid Reading Ease Table is an example of values. While the maximum score is 121.22, there is no limit on how low the score can be. A negative score is valid. |
data.flesh_kincaid_reading_ease.level | Number | The Flesch-Kincaid Grade of the given text. |
data.flesh_kincaid_reading_ease.label | Boolean | If the Flesch Reading Ease score is greater then 70 it is true else false |
data.flesh_kincaid_reading_ease.class | String | Describes the readability class or category, such as College for complex texts, the Flesh Kincaid Reading Ease Table contains all possible values. |
data.flesh_kincaid_reading_ease.class_label | String | Provides a descriptive label for the readability class,the Flesh Kincaid Reading Ease Table contains all possible values like Difficult to read. |
data.stats.paragraphs | Number | The total number of paragraphs in the text. |
data.stats.sentences | Number | The total count of sentences in the text. |
data.stats.words | Number | The total number of words in the text. |
data.stats.characters | Number | The total character count in the text. |
data.stats.reading_time | Number | The estimated time in seconds it would take to read the entire text. |
data.stats.speaking_time | Number | The estimated time in seconds it would take to verbally speak or present the text. |
data.stats.avg_word_length | Number | Average length of words in the text (measured in characters). |
data.stats.avg_sentence_length | Number | Average length of sentences in the text (typically measured in words). |
data.stats.avg_paragraph_length | Number | Average length of paragraphs in the text (often measured in sentences or words). |
Flesh Kincaid Reading Ease Table
Score | Class | Class Label |
---|---|---|
Greater than 90 | 5th grade | Very easy to read. Easily understood by an average 11-year-old student. |
90.0–80.0 | 6th grade | Easy to read. Conversational English for consumers. |
80.0–70.0 | 7th grade | Fairly easy to read. |
70.0–60.0 | 8th & 9th grade | Plain English. Easily understood by 13- to 15-year-old students. |
60.0–50.0 | 10th to 12th grade | Fairly difficult to read. |
50.0–30.0 | College | Difficult to read. |
30.0–10.0 | College graduate | Very difficult to read. Best understood by university graduates. |
Less than 10.0 | Professional | Extremely difficult to read. Best understood by university graduates. |
Sample Response
HTTP Response Codes
The method may return one of the following HTTP status codes:
Status Code | Description |
---|---|
200 | The request was successful. |
401 | Required authentication information is either missing or not valid for the resource. |
400 | Invalid input - the image urls are corrupt or not accessible. |
500 | If any unexpected error occurs while processing the request. |
Authentication
All requests to ApyHub services need to be authenticated, currently we support
tokens
or basic authentication
mechanisms.
You can generate and view your existing credentials from workspace settings (on the left side of the navbar) and go to applications.Points to note:
- Credential secrets are generated on the fly and are not stored in plain text, so on generating a credential please save the secrets somewhere safe.
- Use the
apy-token
as the header parameter to pass the token. - Use the
Authorization
header to send the basic authentication credentials.
Error codes
To search for a specific error code, enter the code in the search box below. Alternatively, you can click on the button to view a complete list of all error codes.