## 它的功能
评估任何英文文本或网址的可读性。返回5个行业标准的可读性分数,实用的通俗英语建议,句子级别的详细分析,并标出最难的句子,以及可选的目标年级通过/不通过。
## 返回的分数
- **Flesch 阅读难易度** — 0–100。分数越高,阅读越容易。
- **Flesch-Kincaid 年级** — 美国学校年级等效。
- **Gunning Fog 指数** — 理解所需的教育年限。
- **自动可读性指数 (ARI)** — 通过字符/单词比率确定的年级水平。
- **SMOG 指数** — 通过多音节词的密度确定的年级水平。
## 使用案例
内容团队,法律/合规,教育科技,SEO工具,内容管理系统管道,A/B文案测试。
## 接口
- `POST /api/analyze` — 分析文本或网址,带可选目标年级
- `POST /api/compare` — 并排比较两个文本
{"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/12905/user+engagement+readability+api/25687/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/12905/user+engagement+readability+api/25688/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."}'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
`POST /api/analyze` 端点返回给定文本或 URL 的可读性分数、建议、句子分解和可选的目标年级结果 `POST /api/compare` 端点提供两个文本的并排比较,包括它们的 Flesch 分数、年级水平以及哪个文本更容易阅读的总结
`analyze`的响应中的关键字段包括`textStats`(单词、句子和字符计数)、`scores`(各种可读性指标)、`overall`(平均年级水平和裁决)、`suggestions`和`sentenceBreakdown`。`compare`的响应包括`text_a`和`text_b`及其各自的分数和`comparison`的摘要
端点 `POST /api/analyze` 接受参数如 `text`(要分析的内容)、`url`(用于获取和分析的 URL)以及可选的 `targetGrade` 用于通过/不通过的评估。端点 `POST /api/compare` 需要比较的两个文本
响应数据以JSON格式结构化 对于`分析`,它包括文本统计、可读性得分、总体评估、建议和句子细分的部分 对于`比较`,它为每个文本的得分提供单独的部分以及比较的总结
典型的使用案例包括创造可以提高可读性的内容简化法律文件评估教育材料评估SEO内容以及进行市场营销文案的A/B测试该API有助于确保内容对目标受众可访问
用户可以利用可读性评分根据目标受众调整内容复杂性 建议可以指导修订,而句子分解有助于识别可能需要简化的复杂句子 比较功能有助于在两篇文本中选择可读性更高的选项
该API使用既定的可读性公式,确保基于语言原则的一致评分 定期更新和对各种文本样本进行测试有助于保持提供评分的准确性和可靠性
用户可以期待Flesch阅读容易度的分数在0到100之间波动更高的分数表示更容易阅读年级水平通常与美国的学年对齐建议通常突出改进的领域尤其是对于较短的文本
服务级别:
100%
响应时间:
670ms
服务级别:
100%
响应时间:
810ms
服务级别:
100%
响应时间:
192ms
服务级别:
100%
响应时间:
147ms
服务级别:
100%
响应时间:
117ms
服务级别:
100%
响应时间:
144ms
服务级别:
100%
响应时间:
1,045ms
服务级别:
100%
响应时间:
1,076ms
服务级别:
100%
响应时间:
474ms
服务级别:
100%
响应时间:
55ms