object
An object containing the overall score, readability, and text statistics.
object
Show readability properties
Show readability properties
integer
Readability score for the submitted text. Score ranges between 0 to 100. Higher score means the text is more readable.
integer
The estimated readability level of the submitted text.Available values:
- 1 - Text is readable for 5th grader
- 2 - Text is readable for 6th grader
- 3 - Text is readable for 7th grader
- 4 - Text is readable for 8th-9th grader
- 5 - Text is readable for 10th-12th grader
- 6 - Text is readable for college student
- 7 - Text is readable for college graduate
- 8 - Text is readable for professional
string
Text corresponding to the estimated readability level. For example: “7th Grader”.
string
Description corresponding to the estimated readability level. For example: “Very easy to read”.
object
object
Show corrections properties
Show corrections properties
integer
Total number of grammar corrections.
integer
Overall grammar score.
number
Grammar category weight in the overall score. This value is configurable upon submission.
integer
Total number of mechanics corrections.
integer
Overall mechanics score.
number
Mechanics category weight in the overall score. This value is configurable upon submission.
integer
Total number of sentence structure corrections.
integer
Overall sentence structure score.
number
Sentence structure category weight in the overall score. This value is configurable upon submission.
integer
Total number of word choice corrections.
integer
Overall word choice score.
number
Word choice category weight in the overall score. This value is configurable upon submission.
integer
Overall writing score. The score is calculated as a weighted average of the correction categories above. Weight for each category is configurable upon submission.
object
An object containing the detailed corrections for the text.
object
Corrections to be applied on the textual version. Each position in the inner arrays corresponds to a single correction to be applied to the textual version. If you use the submit endpoint, the textual version can be retrieved by using the Export endpoint and exporting the crawled version.
Show text properties
Show text properties
object
The character positions of the corrections for the textual version. All nested arrays have the same length and each coordinate corresponds to one correction.
Show chars properties
Show chars properties
array<integer>
The classification of this correction. For example: 12 is Capitalization Error. For a full list of correction types refer to Correction Types documentation.
array<integer>
Starting character position of the suggested text to be corrected in the textual version.
array<integer>
Length in characters of the suggested text to be corrected in the textual version.
array<string>
The recommended text to substitute into the textual version.
object
Metadata about the scan.
Show scannedDocument properties
Show scannedDocument properties
string
The unique scan id provided by you.
integer
Unsigned Integer. Total number of words found in the scanned text.
integer
Unsigned Integer. Number of excluded words in the submitted content.
integer
Overall credits used for the scan.
string<date-time>
The creation time of the scan. Timezone: UTC+0.
object
Show metadata properties
Show metadata properties
string<uri>
The submitted url after all http redirects.
string<uri>
Extracted canonical url from the scanned document.
string<date-time>
Publication date of the scanned document.
string<date-time>
Creation date of the scanned document.
string<date-time>
Last modification date of the scanned document.
string
Scanned document author.
string
Scanned document organization.
string
Scanned document filename.
Example
{
"score": {
"corrections": {
"grammarCorrectionsCount": 2,
"grammarCorrectionsScore": 87,
"grammarScoreWeight": 1.0,
"mechanicsCorrectionsCount": 9,
"mechanicsCorrectionsScore": 38,
"mechanicsScoreWeight": 1.0,
"sentenceStructureCorrectionsCount": 0,
"sentenceStructureCorrectionsScore": 100,
"sentenceStructureScoreWeight": 1.0,
"wordChoiceCorrectionsCount": 1,
"wordChoiceCorrectionsScore": 93,
"wordChoiceScoreWeight": 1.0,
"overallScore": 79
},
"readability": {
"score": 59,
"readabilityLevel": 5,
"readabilityLevelText": "10th to 12th Grader",
"readabilityLevelDescription": "Fairly difficult to read"
},
"statistics": {
"sentenceCount": 5,
"averageSentenceLength": 12.2,
"averageWordLength": 5.5,
"readingTimeSeconds": 16.0,
"speakingTimeSeconds": 28.2
}
},
"corrections": {
"text": {
"chars": {
"types": [
5,
18,
3,
18,
18,
18,
18,
10,
18,
16,
18,
18
],
"starts": [
13,
22,
61,
104,
118,
136,
179,
233,
288,
347,
353,
374
],
"lengths": [
2,
10,
9,
6,
8,
35,
13,
9,
12,
4,
8,
11
],
"operationTexts": [
"an ",
"plagiarism ",
"businesses ",
"their ",
"original.",
"texts from the internet and data bases ",
"similarities.",
"multilingual ",
"positives, ",
"it's ",
"useful ",
"maintaining "
]
}
}
},
"scannedDocument": {
"scanId": "{scanId}",
"totalWords": 61,
"totalExcluded": 0,
"credits": 1,
"expectedCredits": 1,
"creationTime": "2025-08-11T06:46:01.2886658Z"
}
}
Next Steps
Assess Grammar & Writing Quality
Learn how to use the Grammar Checker API to detect and correct writing issues.
Correction Types
See a detailed list of all supported correction types and languages.
Export Method
Learn how to export scan results, including Grammar Checker data.