{"success":true,"textStats":{"wordCount":18,"sentenceCount":2,"characterCount":85,"avgSentenceLength":9,"avgSyllablesPerWord":1.56,"polysyllabicWordCount":1,"polysyllabicWordPercentage":5.6},"scores":{"fleschReadingEase":{"score":66.1,"interpretation":"Standard","suitableFor":"Age 15–17"},"fleschKincaidGrade":{"score":6.3,"interpretation":"US Grade 6 reading level"},"gunningFog":{"score":5.8,"interpretation":"Very easy"},"automatedReadabilityIndex":{"score":5.3,"interpretation":"Roughly Grade 5 reading level"},"smogIndex":{"score":6.9,"interpretation":"Grade 7 reading level","note":"SMOG is most accurate with 30+ sentences"}},"overall":{"averageGradeLevel":6.1,"verdict":"Easy read","recommendedFor":"Most adults","plainEnglishScore":70},"suggestions":["Text is short (18 words). Readability scores are most reliable with 100+ words."],"sentenceBreakdown":{"all":[{"index":1,"sentence":"The quick brown fox jumps over the lazy dog.","wordCount":9,"fre":94.3,"grade":2.3,"complexity":"Easy"},{"index":2,"sentence":"This is a simple sentence for testing readability scores.","wordCount":9,"fre":37.9,"grade":10.2,"complexity":"Hard"}],"hardest":[{"index":2,"sentence":"This is a simple sentence for testing readability scores.","wordCount":9,"fre":37.9,"grade":10.2,"complexity":"Hard"},{"index":1,"sentence":"The quick brown fox jumps over the lazy dog.","wordCount":9,"fre":94.3,"grade":2.3,"complexity":"Easy"}]}}
curl --location --request POST 'https://zylalabs.com/api/12900/legal+compliance+readability+api/25679/analizar' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"text": "The quick brown fox jumps over the lazy dog. This is a simple sentence for testing readability scores."}'
{"success":true,"text_a":{"fleschReadingEase":100,"gradeLevel":2.1,"verdict":"Very easy read","wordCount":11},"text_b":{"fleschReadingEase":0,"gradeLevel":19.4,"verdict":"Highly technical","wordCount":15},"comparison":{"moreReadable":"text_a","easeDifference":100,"gradeDifference":17.3,"summary":"text_a is easier to read by 100.0 Flesch points"}}
curl --location --request POST 'https://zylalabs.com/api/12900/legal+compliance+readability+api/25680/comparar' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"text_a": "The cat sat on the mat. It was a sunny day.", "text_b": "The feline proceeded to position itself upon the horizontal surface whilst meteorological conditions remained favourable."}'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 法律合规可读性 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
## 它的功能
对任何英文文本或网址进行可读性评分。返回5个行业标准可读性分数,可操作的通俗英语建议,逐句分析并标记出最难理解的句子,以及可选的目标年级及及格/不及格。
## 返回的分数
- **Flesch阅读容易度** — 0–100。分数越高 = 读起来越容易。
- **Flesch-Kincaid年级** — 相当于美国学校年级。
- **Gunning Fog指数** — 理解所需的教育年限。
- **自动可读性指数(ARI)** — 通过字符/单词比例确定年级水平。
- **SMOG指数** — 通过多音节单词密度确定年级水平。
## 用例
内容团队、法律/合规、教育科技、搜索引擎优化工具、内容管理系统流程、A/B文案测试。
## 端点
- `POST /api/analyze` — 分析文本或网址,附选目标年级
- `POST /api/compare` — 并排比较两段文本
端点 `POST /api/analyze` 返回可读性评分 建议 句子分解 和一个可选的目标年级结果 端点 `POST /api/compare` 提供两个文本的并排比较 包括它们的可读性评分 年级水平 和一个关于哪个文本更易读的总结
`analyze` 响应中的关键字段包括 `textStats`(单词、句子、字符计数)、`scores`(各种可读性指标)、`overall`(平均年级水平和裁定)以及 `suggestions`。`compare` 响应包含 `text_a` 和 `text_b` 字段及其各自的分数以及 `comparison` 摘要
终点 `POST /api/analyze` 接受参数如要分析的文本或URL以及进行评估的可选评分 终点 `POST /api/compare` 需要两个文本进行比较 用户可以通过提供不同的文本或URL 来定制他们的请求
响应数据以JSON格式结构化 对于`分析`包括`成功` `文本统计` `评分` `一般` `建议` 和 `句子细分` 的部分 `比较`的响应包含`成功` `文本_a` `文本_b` 和 `比较`部分 方便访问特定信息
典型的用例包括内容团队提高文档清晰度 法律/合规团队确保合同可读性 教育科技应用评估教育材料 以及搜索引擎优化工具优化网络内容 该API还帮助进行文案有效性的A/B测试
用户可以利用可读性分数来调整文本的复杂性以适应目标受众。例如,如果某个文档在Flesch-Kincaid等级上的得分过高,用户可以根据提供的建议来简化语言。句子分析有助于识别和修订复杂句子
该API采用了既定的可读性公式,确保分数一致可靠每个公式都基于语言学研究,API的设计允许实时分析,在不同类型和长度的文本中保持准确性
用户可以期待可读性分数根据文本的复杂性而有所不同例如较短的文本可能会给出不太可靠的分数而较长的文本(超过100个词)提供更准确的评估API标识复杂句子帮助用户识别需要改进的领域