{"openapi":"3.1.0","info":{"title":"Readability","version":"0.1.0","description":"English readability analysis — the standard formulas (Flesch Reading Ease, Flesch–Kincaid, Gunning fog, SMOG, Coleman–Liau, ARI), a consensus grade level, per-word syllable counts and reading/speaking-time estimates.","x-guidance":"English readability analysis — the standard formulas (Flesch Reading Ease, Flesch–Kincaid, Gunning fog, SMOG, Coleman–Liau, ARI), a consensus grade level, per-word syllable counts and reading/speaking-time estimates. Each operation is an HTTP POST to its /v1/<operation> path with a JSON request body (see each operation's requestBody schema) and returns a JSON response. Endpoints are paid per successful call via x402 or MPP (USDC on Base); an unpaid request returns 402 with payment metadata in the WWW-Authenticate header.","contact":{"email":"hello@openverbs.com"}},"x-discovery":{"ownershipProofs":["0xb1401a71756f51464a9962db12f1eb3e9522490cd20010b06d00cf7b7770acfd5f79721f9dfdf2643f8cecd29af3bde9ec133941a386042b32d9886053a70de61b","0xc1c1f11793e18a00fcb7072421f26e89fb75b6aa517fa84370564991f4b10efa024f6f57e4e67eefd20cf46cc01fc5a62d793fa8fbcda04f26c946a3433d73f91b","0x676b474af0ef9ed4809b5d12d2e789b36e52d56215b21f601d71f76620e36ec630347116a7b2b349a3c3681e5db0fbfa76c4169a676b6d6f27864d0e5017284a1c","0xc2ab96522515ed9e9bc4f1a241b774bd48df42e951ddbf7f6aa8fc76f5a96a20421703e1ec402ce7eb1e4eabea3b6e4e4129cf39d56ea91cf4fcf38561fc94fc1c"]},"servers":[{"url":"https://readability.openverbs.com"}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}},"/v1/score":{"post":{"summary":"Readability scores","description":"Compute the standard English readability formulas — Flesch Reading Ease, Flesch–Kincaid grade, Gunning fog, SMOG, Coleman–Liau and ARI — along with the underlying sentence/word/syllable statistics. Empty text is a clean 400. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["readability score","text readability api","flesch score calculator","reading ease analysis","grade formula scores"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text to analyse."}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"`{ stats: { sentences, words, syllables, characters, complexWords, … }, scores: { fleschReadingEase, fleschKincaidGrade, gunningFog, smog, colemanLiau, automatedReadabilityIndex } }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ stats: { sentences, words, syllables, characters, complexWords, … }, scores: { fleschReadingEase, fleschKincaidGrade, gunningFog, smog, colemanLiau, automatedReadabilityIndex } }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Compute the standard English readability formulas — Flesch Reading Ease, Flesch–Kincaid grade, Gunning fog, SMOG, Coleman–Liau and ARI — along with the underlying sentence/word/syllable statistics. Empty text is a clean 400.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Compute the standard English readability formulas — Flesch Reading Ease, Flesch–Kincaid grade, Gunning fog, SMOG, Coleman–Liau and ARI — along with the underlying sentence/word/syllable statistics. Empty text is a clean 400.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Compute the standard English readability formulas — Flesch Reading Ease, Flesch–Kincaid grade, Gunning fog, SMOG, Coleman–Liau and ARI — along with the underlying sentence/word/syllable statistics. Empty text is a clean 400.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/grade":{"post":{"summary":"Consensus grade level","description":"Summarise a text's difficulty as a single consensus US grade level (averaging the five grade formulas), plus the Flesch Reading Ease, a plain-language difficulty band and an approximate age range. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["grade level estimate","text difficulty grade","reading grade level","consensus readability grade","age range readability"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text to grade."}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"`{ gradeLevel, readingEase, difficulty, ageRange, contributingGrades }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ gradeLevel, readingEase, difficulty, ageRange, contributingGrades }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Summarise a text's difficulty as a single consensus US grade level (averaging the five grade formulas), plus the Flesch Reading Ease, a plain-language difficulty band and an approximate age range.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Summarise a text's difficulty as a single consensus US grade level (averaging the five grade formulas), plus the Flesch Reading Ease, a plain-language difficulty band and an approximate age range.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Summarise a text's difficulty as a single consensus US grade level (averaging the five grade formulas), plus the Flesch Reading Ease, a plain-language difficulty band and an approximate age range.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/syllables":{"post":{"summary":"Count syllables","description":"Count syllables per word and in total across the text. Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["count syllables","syllable counter","word syllable lookup","text syllable count","parse word syllables"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Word or text to count syllables in."}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"`{ words: [{ word, syllables }], total, wordCount }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ words: [{ word, syllables }], total, wordCount }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Count syllables per word and in total across the text.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Count syllables per word and in total across the text.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Count syllables per word and in total across the text.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/reading-time":{"post":{"summary":"Reading & speaking time","description":"Estimate reading and speaking time for a text at configurable words-per-minute rates (defaults: 200 wpm reading, 130 wpm speaking). Paid endpoint (x402 + MPP). Price: $0.002000 USDC per successful payment.","tags":["reading time estimate","speaking time estimate","words per minute calculator","estimate read time","text duration api"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text to estimate time for."},"readingWpm":{"type":"number","exclusiveMinimum":0,"description":"Reading rate in words per minute. Default 200."},"speakingWpm":{"type":"number","exclusiveMinimum":0,"description":"Speaking rate in words per minute. Default 130."}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"`{ words, reading: { wpm, minutes, seconds, humanReadable }, speaking: { … } }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ words, reading: { wpm, minutes, seconds, humanReadable }, speaking: { … } }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Estimate reading and speaking time for a text at configurable words-per-minute rates (defaults: 200 wpm reading, 130 wpm speaking).","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"2000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Estimate reading and speaking time for a text at configurable words-per-minute rates (defaults: 200 wpm reading, 130 wpm speaking).","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"2000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Estimate reading and speaking time for a text at configurable words-per-minute rates (defaults: 200 wpm reading, 130 wpm speaking).","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}}},"x-service-info":{"categories":["text"],"docs":{"homepage":"https://readability.openverbs.com","apiReference":"https://readability.openverbs.com/openapi.json"}}}