Readabiliy Scores API

Get various readability scores for a given text.

Enhance Content Clarity with Readability Scores API

Make your content accessible to everyone with our Readability Scores API—an advanced tool that analyzes text readability and ensures your message resonates with your target audience.

Why Choose Our API?

Comprehensive Readability Metrics: Get insights from industry-standard readability formulas, including Flesch-Kincaid, Gunning Fog, SMOG, and more.

• Instant Analysis: Process text in real-time and receive instant feedback on readability.
• Versatile Integration: Easily integrate into your apps, CMS platforms, and workflows via a simple API.
• Improve Engagement & SEO: Optimize content readability to boost user retention and search rankings.
• Supports Multiple Languages: Analyze text in various languages to enhance global accessibility.

Who Can Benefit?

• Content Marketers & SEO Experts: Ensure your content is digestible and ranks higher.
• Developers & SaaS Platforms: Integrate readability scoring into your applications.
• Educators & Publishers: Tailor content to the appropriate reading level.
• Journalists & Writers: Enhance readability and audience engagement.

API End Points

The end point for connecting : If you subscribe directly from us use this endpoint.

	https://api.interfaces.one

Token issues and Unauthenticated Response

Any calls without a token or an invalid token will result in a 401 error with the following message.

{
    "message": "Unauthenticated."
}

API Documentation

To get readability scores for a given text use the following API endpoint.

   GET /readability/scores

   Parameters
       text={text}

The above call will generate a response like the one below.

{
    "success": {
        "total": 13
    },
    "contents": {
        "Flesch-Kincaid Reading Ease": 68,
        "Flesch-Kincaid Grade Level": 8.5,
        "Coleman-Liau Index": 9.9,
        "Gunning-Fog score": 11.5,
        "SMOG Index": 11,
        "Automated Readability Index": 8.6,
        "Dale-Chall readability score": 4.7,
        "Spache readability score": 5,
        "Average words per sentence": 19,
        "Average syllables per word": 1.41,
        "3 Syllable words Percentage": "9.77%",
        "Total word count": 133,
        "Reading Time in mins": 1
    },
    "copyright": {
        "url": "api.interfaces.one",
        "year": "2025"
    }
}

Ratelimiting

Some of our API calls may be public(requires free API key) , while others requires paid subscription. To maintain our serice levels both public and private API endpoints are ratelimited. Please consult your specific plan that you subscribed to for the rate limit details.

Authentication

Currently we support API Key based authentication. Please set your Autorization Bearer request header with value of your API key. Alternatively you can also pass api_key= as a request parameter, though we strongly discourage this mode of passing the key, since it will allow others to see your key.

In curl this would mean sending the Authorization header like below.

            
 curl -i <url> -H "Authorization: Bearer <api_key>"
            
            

If you are using PHP.

            
$authorization = "Authorization: Bearer <api_key>";
$ch = curl_init('<url>'); // Initialise cURL
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json' , $authorization ));
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); // OR GET
$result = curl_exec($ch);
curl_close($ch);
            
            

In javascript you can use headers key to add the authorization header

            
$.ajax({
   url: '<url>'
   type: 'GET',
   contentType: 'application/json'
   headers: {
      'Authorization': 'Bearer <api_key>'
   },
   success: function (result) {
       // CallBack(result);
   },
   error: function (error) {

   }
});