{"uid":"cap_CZJhXPhUOTp7zPPHxRQ2A","slug":"readability-grade-level-api-002f8e9c","name":"Readability Grade Level API","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.","url":"https://readability.openverbs.com/v1/grade","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Text to grade."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qSZPMjRPS-8fdUxdNBhTr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a consensus US grade level (averaging five readability formulas), Flesch Reading Ease score, plain-language difficulty band, and approximate reader age range for a given text.","exampleAgentPrompt":"Can you check the reading level of this text and tell me what US grade it targets, the Flesch Reading Ease score, and roughly what age range it's suited for? Here's the text: 'The mitochondria are organelles found in eukaryotic cells that generate most of the cell's supply of ATP, used as a source of chemical energy.'","exampleUseCases":[{"title":"Checking blog post accessibility","prompt":"I just wrote this blog post intro and want to know if it's accessible to a general adult audience — can you get me the grade level, reading ease score, and difficulty band? Here's the text: 'Climate change is accelerating at an unprecedented rate, driven by anthropogenic greenhouse gas emissions that are fundamentally altering the planet's atmospheric composition.'"},{"title":"Educational content grading","prompt":"I'm writing a worksheet for 5th graders and need to check if this paragraph is at the right level — what US grade level does it score, and what age range does it suit? Text: 'Plants make their own food using sunlight, water, and carbon dioxide in a process called photosynthesis. The green color in leaves comes from a chemical called chlorophyll.'"},{"title":"Legal document readability audit","prompt":"Can you run a readability grade check on this contract clause and tell me the consensus grade level, Flesch Reading Ease, and difficulty band? Clause: 'The indemnifying party shall defend, indemnify, and hold harmless the indemnified party from and against any and all claims, damages, losses, costs, and expenses arising out of or relating to any breach of this Agreement.'"}],"resultDescription":"Returns a consensus US grade level (average of five standard readability formulas), a Flesch Reading Ease score (0–100), a plain-language difficulty band (e.g. 'Easy', 'Standard', 'Difficult'), and an approximate reader age range (e.g. '10–12 years').","failureModes":["Missing 'text' field in request body returns a validation error","Empty or extremely short text may produce unreliable or undefined grade scores","Non-English text may yield inaccurate results as formulas are calibrated for English","Payment not provided or insufficient USDC causes x402 payment required error"],"whenToPreferThis":"Choose this endpoint when you need a single, consensus readability verdict rather than individual formula scores. It averages five formulas to reduce variance, making it ideal for content accessibility audits, editorial workflows, or automated content gatekeeping. Prefer sibling endpoints if you need the raw scores from each individual formula or separate syllable/word counts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:41:22.452Z","isFirstParty":false}