Text Readability Score API

Analyze text readability and complexity with multiple scoring algorithms: Flesch-Kincaid Grade Level, Flesch Reading Ease, Gunning Fog, SMOG, Coleman-Liau, and Automated Readability Index (ARI). Returns reading grade level, audience suitability, and sentence/word-level metrics. Ideal for content editors, SEO tools, LMS platforms, and writing assistants.

原始信息汇总

Text Readability Score API 数据集概述

基本信息

• API名称: Text Readability Score API
• 提供商: API Phase Studio
• 类别: 文本分析 (Text Analysis)

核心功能

• 多公式分析: 一次性提交任意英文文本，可同时获取十种可读性公式的评分。
• 选择性分析: 支持运行全部十个公式、单个公式或任意子集。
• 共识计算: 当运行所有公式时，API自动计算基于七个年级水平公式的平均共识年级水平。
• 文本统计: 每个响应都包含完整的原始文本统计数据，包括单词数、句子数、音节数、多音节词数、字符数以及每单词和每句子的平均值。
• 边缘情况处理: 对于无法在提交文本上运行的公式（例如，SMOG需要至少三个句子），会返回结构化警告而非错误。

支持的端点

端点	用途
POST /v1/analyse	使用一个、多个或所有公式分析文本
POST /v1/analyse/{method}	通过URL使用单个公式分析文本
GET /v1/methods	列出所有可用的公式键和标签
GET /v1/health	服务健康检查

可读性公式

键	公式	测量内容
flesch	Flesch Reading Ease	分数0–100；分数越高表示越容易阅读
flesch_kincaid	Flesch-Kincaid Grade	基于音节和句子长度的美国学校年级水平
smog	SMOG Index	基于多音节词的年级水平；需要3个以上句子
gunning_fog	Gunning Fog	年级水平；惩罚长句和复杂词汇
coleman_liau	Coleman-Liau	使用字符数而非音节的年级水平
ari	Automated Readability	具有相应读者年龄范围的年级水平
dale_chall	Dale-Chall	基于单词对年轻读者熟悉度的年级水平
linsear_write	Linsear Write	年级水平；最初为美国空军手册开发
spache	Spache	为小学年级文本（1-3年级）优化的年级水平
powers_sumner_kearl	Powers-Sumner-Kearl	具有更新系数的修订版Flesch年级水平

使用案例

• 内容分级: 在发布文章、博客文章或帮助文档之前，根据目标受众的阅读水平进行评分。
• 教育平台: 自动按难度对阅读材料进行分类。
• 无障碍审计: 检查产品文案、法律声明或支持文章是否符合通俗语言标准。
• 内容管道: 将可读性评分集成到CMS或发布工作流程中。
• A/B测试单个公式: 当您已经知道哪个公式与您的领域最相关时，直接调用该公式。
• 公式比较研究: 在语料库中单独调用多个公式，以研究不同评分模型对同一文本的差异。
• 动态公式选择UI: 在运行时获取支持的公式完整列表，以填充应用程序中的下拉列表或设置面板。

技术规格与限制

• 文本长度限制: 最大输入为 10,000 个字符（大约1,500–2,000个单词）。
• 语言支持: 仅支持英文。
• 单词计数: word_count 仅计算字母标记。数字、标点和独立符号被排除在所有公式计算之外。
• 共识计算: 共识基于七个年级水平公式计算：flesch_kincaid、smog、gunning_fog、coleman_liau、ari、linsear_write 和 powers_sumner_kearl。Flesch Reading Ease使用0-100分制，因此被排除。Dale-Chall和Spache因其量表与美国年级数字无法直接比较而被排除。

HTTP状态码

代码	含义
200	请求处理成功。所有请求的公式都已运行。
422	验证错误：缺少或为空的text，文本超过10,000个字符，或未知的公式键。
429	超出当前计划的速率限制。
500	内部服务器错误。

订阅计划

• BASIC: $0.00 / 月
• PRO: $3.99 / 月
• ULTRA: $13.99 / 月
• MEGA: $44.99 / 月