{"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/12904/accessibility+compliance+readability+api/25685/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/12904/accessibility+compliance+readability+api/25686/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 हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
## यह क्या करता है
किसी भी अंग्रेजी पाठ या URL की पठनीयता को स्कोर करें। 5 उद्योग मानक पठनीयता स्कोर, क्रियाशील साधारण अंग्रेजी सुझाव, वाक्य स्तर की ब्रेकडाउन जिसमें सबसे कठिन वाक्य चिह्नित हैं, और वैकल्पिक लक्ष्य ग्रेड पास/फेल लौटाता है।
## लौटाए गए स्कोर
- **फ्लेश रीडिंग ईज** — 0–100। उच्च = पढ़ने में आसान।
- **फ्लेश-किंकेड ग्रेड** — अमेरिकी स्कूल ग्रेड समकक्ष।
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष।
- **स्वचालित पठनीयता सूचकांक (ARI)** — अक्षर/शब्द अनुपात के माध्यम से ग्रेड स्तर।
- **SMOG इंडेक्स** — बहु-श्रव्य शब्द घनत्व के माध्यम से ग्रेड स्तर।
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, एडटेक, SEO उपकरण, CMS पाइपलाइन, A/B कॉपी परीक्षण।
## एंडपॉइंट्स
- `POST /api/analyze` — पाठ या URL का विश्लेषण करें, वैकल्पिक लक्ष्य ग्रेड के साथ
- `POST /api/compare` — दो पाठों की तुलना करें एक साथ
`POST /api/analyze` एंडपॉइंट पठनीयता स्कोर, सुझाव, वाक्य विभाजन और एक वैकल्पिक लक्ष्य ग्रेड परिणाम लौटाता है `POST /api/compare` एंडपॉइंट दो पाठों की साइड-बाय-साइड तुलना प्रदान करता है जिसमें उनके पठनीयता स्कोर, ग्रेड स्तर और यह सारांश शामिल है कि कौन सा पाठ पढ़ने में आसान है
`analyze` के उत्तर में प्रमुख क्षेत्र हैं `textStats` (शब्दों, वाक्यों, अक्षरों की गिनती), `scores` (फ्लेश की पढ़ने की आसानी, फ्लेश-किंकाईड ग्रेड आदि), `overall` (औसत ग्रेड स्तर, निर्णय) और `suggestions` `compare` का उत्तर `text_a` और `text_b` के स्कोर, निर्णय और `comparison` का सारांश शामिल करता है
उत्तर डेटा JSON प्रारूप में संरचित हैं `विश्लेषण` के लिए इसमें पाठ के सांख्यिकी पढ़ने की योग्यता सामान्य मूल्यांकन सुझाव और वाक्यों का विस्तृत विवरण शामिल हैं उत्तर `तुलना` डेटा को प्रत्येक पाठ के लिए अलग-अलग वर्गों और तुलना का एक सारांश प्रस्तुत करता है
`POST /api/analyze` एंडपॉइंट टेक्स्ट या विश्लेषण करने के लिए URL के लिए पैरामीटर स्वीकार करता है और मूल्यांकन के लिए एक वैकल्पिक लक्ष्य ग्रेड है `POST /api/compare` एंडपॉइंट तुलना के लिए दो टेक्स्ट की आवश्यकता होती है उपयोगकर्ता विभिन्न टेक्स्ट या URLs प्रदान करके अनुरोधों को अनुकूलित कर सकते हैं
टिपिकल उपयोग के मामले में पहुंच क्षमता के लिए सामग्री का निर्माण कानूनी अनुपालन की जांच शैक्षिक सामग्री का विकास SEO का अनुकूलन और मार्केटिंग की कॉपी के लिए A/B परीक्षण शामिल हैं API यह सुनिश्चित करने में मदद करता है कि सामग्री लक्षित दर्शकों के लिए समझने योग्य हो
उपयोगकर्ता पठनीयता स्कोर का लाभ उठाकर सामग्री की जटिलता को समायोजित कर सकते हैं सुझावों का उपयोग करके स्पष्टता में सुधार कर सकते हैं और चुनौतीपूर्ण वाक्यों की पहचान करने के लिए वाक्य संरचना का विश्लेषण कर सकते हैं यह डेटा सामग्री को विशिष्ट दर्शकों या अनुपालन मानकों के अनुसार अनुकूलित करने में मदद करता है
एपीआई स्थापित पठनीयता फ़ार्मुलों और एल्गोरिदम का उपयोग करके स्कोर गणना करने के लिए निरंतरता और विश्वसनीयता सुनिश्चित करती है नियमित अपडेट और ज्ञात मानकों के खिलाफ परीक्षण डेटा की सटीकता और गुणवत्ता बनाए रखने में मदद करते हैं
उपयोगकर्ता यह उम्मीद कर सकते हैं कि पाठ की पठनीयता के लिए फ्लेश की स्कोर 0 से 100 के बीच में हो सकती है जिनका उच्च स्कोर आसान पठनीयता का संकेत देता है ग्रेड स्तर पाठ की जटिलता के अनुसार भिन्न होगा और सुझाव आम तौर पर सुधार के लिए क्षेत्र को उजागर करेंगे विशेष रूप से छोटे पाठों में