{"uid":"cap_a53V--Go2wwoaAPJ0vuKY","slug":"energybilltoolkit-co-uk-895f8ba1","name":"energybilltoolkit.co.uk Text Readability Estimator","description":"Return rough English readability estimates with caveats for short, bullet-heavy, heading-heavy, or mixed-language text.","url":"https://energybilltoolkit.co.uk/text-metrics/api/tools/readability","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","description":"Text to measure."}}},"responseSchema":null,"example":{"request":{"text":"Energy efficiency tips for reducing your bills: • Turn off lights when not in use. • Install LED bulbs to save electricity. • Reduce heating temperature by 1°C. • Use a programmable thermostat. • Insulate your home properly."},"response":{"metric":"readability","warnings":[{"code":"short_text","message":"Readability and frequency metrics are unstable below about 100 words.","severity":"caution"}],"readability":{"method":"English Flesch formulas with heuristic syllable counting; directional, not authoritative.","syllables":60,"flesch_reading_ease":50.64,"flesch_kincaid_grade":7.89,"average_syllables_per_word":1.765,"average_sentence_length_words":6.8}}},"exampleRequest":{"text":"Energy efficiency tips for reducing your bills: • Turn off lights when not in use. • Install LED bulbs to save electricity. • Reduce heating temperature by 1°C. • Use a programmable thermostat. • Insulate your home properly."},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FwJq9xqawZywNIwbu1Ydi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns rough English readability estimates (e.g. Flesch, grade level) with caveats for text that is short, bullet-heavy, heading-heavy, or mixed-language.","exampleAgentPrompt":"Can you give me a readability estimate with caveats for this text — it's a short bullet-point list with some headings: 'Energy saving tips: • Turn off lights. • Use LED bulbs. • Reduce heating by 1°C.'","exampleUseCases":null,"resultDescription":"Returns rough English readability scores (such as Flesch Reading Ease or grade-level estimates) along with specific caveats explaining when the estimate may be unreliable — e.g. if the text is too short, dominated by bullets or headings, or contains mixed-language content.","failureModes":["Empty or missing text body returns an error or zero-score response","Non-English or heavily mixed-language text returns low-confidence scores with caveats","Extremely short text (1-2 words) may produce unreliable scores flagged with warnings","Malformed JSON request body returns a 400-level error","Text consisting entirely of headings or bullets may return a caveat-only response with no reliable score"],"whenToPreferThis":"Use this endpoint when you need a quick English readability estimate and want honest caveats about reliability — especially for short, structured, or mixed-language content where standard readability formulas are known to mislead. Prefer this over generic NLP libraries when you need built-in transparency about estimate limitations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:46.068Z","isFirstParty":false}