{"openapi":"3.1.0","info":{"title":"Readability API","version":"1.0.0","description":"Score how easy a piece of text is to read using the standard, peer-reviewed readability formulas — Flesch Reading Ease, Flesch-Kincaid Grade, Gunning Fog, SMOG, Coleman-Liau and the Automated Readability Index. Pass text and get all six scores back together with the underlying counts (words, sentences, syllables, complex and polysyllabic words, letters and characters), an averaged grade level, an estimated reading time and a plain-English interpretation of the reading ease. A second endpoint counts syllables for a word or for every word in a phrase. Supply text inline via ?text=, as a query parameter or in a request body; everything is computed locally with no network calls, so it is fast and deterministic. Built for content and copywriting tools, SEO and editorial workflows, education and accessibility (plain-language) checks, and UX-writing review. A readability scorer — distinct from sentiment/NLP analysis (nlp), spelling and grammar checking (grammar), the case and text utilities (text) and string similarity (similarity). No upstream key, no cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/readability-api","description":"oanor gateway"}],"tags":[{"name":"Readability"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/analyze":{"get":{"operationId":"get_v1_analyze","tags":["Readability"],"summary":"Readability scores for text","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"The text to analyse","schema":{"type":"string"},"example":"The quick brown fox jumps over the lazy dog. It was a bright cold day in April, and the clocks were striking thirteen."}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"counts":{"words":23,"letters":93,"sentences":2,"syllables":28,"characters":118,"complex_words":0,"polysyllables":0},"scores":{"smog_index":3.13,"gunning_fog":4.6,"coleman_liau_index":5.4,"flesch_reading_ease":92.17,"flesch_kincaid_grade":3.26,"automated_readability_index":3.36},"interpretation":"Very easy — 5th grade","average_grade_level":4,"reading_time_seconds":7},"meta":{"timestamp":"2026-06-01T23:40:49.601Z","request_id":"55b5013d-f9a1-4513-9362-13487ea17806"},"status":"ok","message":"Readability analyzed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/syllables":{"get":{"operationId":"get_v1_syllables","tags":["Readability"],"summary":"Syllable count","description":"","parameters":[{"name":"text","in":"query","required":true,"description":"A word or phrase","schema":{"type":"string"},"example":"readability scoring"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"words":[{"word":"readability","syllables":5},{"word":"scoring","syllables":2}],"word_count":2,"total_syllables":7},"meta":{"timestamp":"2026-06-01T23:40:49.703Z","request_id":"106e4e3b-2e55-4739-94a4-97112867643f"},"status":"ok","message":"Syllables counted","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Formulas computed","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Score how easy a piece of text is to read using the standard, peer-reviewed readability formulas. /v1/analyze?text=... returns the Flesch Reading Ease (0-100, higher is easier), the Flesch-Kincaid grade level, Gunning Fog, SMOG, Coleman-Liau and the Automated Readability Index, together with the underlying counts (words, sentences, syllables, complex and polysyllabic words, letters, characters), an averaged grade level, an estimated reading time and a plain-English interpretation. /v1/syllables counts syllables for a word or every word in a phrase. Supply text via ?text=, a query parameter or a request body; everything is computed locally with no network calls. Ideal for content and copywriting tools, SEO and editorial workflows, education and accessibility (plain-language) checks, and UX-writing review. A readability scorer — distinct from sentiment/NLP (nlp), spelling and grammar (grammar), the case/text utilities (text) and string similarity (similarity). No key, no cache.","formulas":["Flesch Reading Ease","Flesch-Kincaid Grade","Gunning Fog","SMOG Index","Coleman-Liau Index","Automated Readability Index"],"endpoints":["/v1/analyze","/v1/syllables","/v1/meta"]},"meta":{"timestamp":"2026-06-01T23:40:49.800Z","request_id":"f0d263e9-533b-4a0d-b77c-1704b3ff23ec"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2340,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":680,"monthly_call_quota":46500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2150,"monthly_call_quota":238000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5680,"monthly_call_quota":875000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/readability-api"}