Thank you! Your feedback helps us improve.

Writing Score API

Included in: Grammarly Enterprise and Grammarly for Education plans

The Writing Score API allows organizations to evaluate the quality of individual written documents by receiving an overall Grammarly score, as well as separate scores in four categories: engagement, correctness, tone, and clarity. The Writing Score API is available through the HTTP REST interface, enabling organizations to build custom applications that integrate seamlessly with Grammarly.

How it works

The Writing Score API receives a document and extracts the text from it. The extracted text is initially assumed to be 100% correct. Grammarly then generates writing suggestions in four categories: engagement, correctness, tone, and clarity. The suggestions are then prioritized and weighted. Finally, Grammarly calculates a score based on the suggestions and subtracts that score from the original 100% score. The resulting score is returned in the response to the API request.

Note: Supported document types are DOC, DOCX, ODT, TXT, RTF, and PDF.

Here’s an example of what a custom-built application that uses the Writing Score API might look like:

Writing Score.png

Getting started with the Writing Score API

The Writing Score API is included in Grammarly Enterprise and Grammarly for Education plans.

Interested in upgrading to an Enterprise account? Contact our Sales team.

The API is intended for programmatic consumption and is accessible through an HTTP REST interface. Access to the API requires authentication using an Access Token provided by Grammarly’s OAuth functionality. You can learn more about OAuth credentials in this article: Receive OAuth 2.0 credentials

To start integrating the Writing Score API, review the API documentation.

Was this article helpful?
Tell us what you think. We promise to act on your feedback to make Grammarly's support pages even more helpful.
Have more questions? Submit a request
API