## यह क्या करता है
कोई भी अंग्रेजी पाठ या URL की पठनीयता को स्कोर करता है। 5 उद्योग-मानक पठनीयता स्कोर, कार्यात्मक सरल अंग्रेजी सुझाव, वाक्य स्तर का विभाजन जिसमें सबसे कठिन वाक्य हाइलाइट किए गए हैं, और वैकल्पिक लक्षित ग्रेड पास/फेल लौटाता है।
## लौटाए गए स्कोर
- **फ्लेश रीडिंग ईज़** — 0–100। उच्च = पढ़ने में आसान।
- **फ्लेश-किंकैड ग्रेड** — अमेरिकी स्कूल ग्रेड समकक्ष।
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष।
- **स्वचालित पठनीयता इंडेक्स (एआरआई)** — अक्षर/शब्द अनुपात के माध्यम से ग्रेड स्तर।
- **स्मॉग इंडेक्स** — बहु-व्यंजक शब्द घनत्व के माध्यम से ग्रेड स्तर।
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, एज-टेक, SEO उपकरण, CMS पाइपलाइन्स, A/B कॉपी परीक्षण।
## एंडपॉइंट्स
- `POST /api/analyze` — पाठ या URL का विश्लेषण करें, वैकल्पिक लक्षित ग्रेड के साथ
- `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/12906/academic+readability+analysis+api/25689/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/12906/academic+readability+analysis+api/25690/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."}'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
`POST /api/analyze` एंडपॉइंट पठनीयता स्कोर, सुझाव, वाक्य विघटन और एक वैकल्पिक लक्ष्य ग्रेड परिणाम लौटाता है `POST /api/compare` एंडपॉइंट दो पाठों की तुलना करता है जिसमें फ्लेश स्कोर, ग्रेड स्तर और पठनीयता निर्णय शामिल होते हैं
मुख्य क्षेत्र में शामिल हैं `wordCount` `sentenceCount` `scores` (जैसे `fleschReadingEase` और `gunningFog`) `overall` (जिसमें `averageGradeLevel` और `verdict`) और `suggestions` पाठ की पठनीयता को सुधारने के लिए हर क्षेत्र पाठ की पठनीयता के बारे में जानकारी प्रदान करता है
उत्तर डेटा JSON प्रारूप में संरचित है `POST /api/analyze` के लिए `textStats` `scores` `overall` `suggestions` और `sentenceBreakdown` शामिल हैं `POST /api/compare` के लिए `text_a` `text_b` और `comparison` के खंड हैं जिससे पढ़ने की क्षमता का आसान मूल्यांकन हो सके
`POST /api/analyze` एंडपॉइंट विश्लेषण के लिए टेक्स्ट या यूआरएल जैसे पैमानों को स्वीकार करता है और मूल्यांकन के लिए एक वैकल्पिक लक्ष्य ग्रेड की आवश्यकता होती है `POST /api/compare` एंडपॉइंट की तुलना के लिए दो टेक्स्ट की आवश्यकता होती है
उपयोगकर्ता विश्लेषण के लिए विशिष्ट पाठ या यूआरएल प्रदान करके अनुरोधों को अनुकूलित कर सकते हैं और `POST /api/analyze` एंडपॉइंट में एक लक्षित ग्रेड स्तर सेट कर सकते हैं यह उपयोगकर्ता की आवश्यकताओं के आधार पर अनुकूलित पठनीयता आकलनों की अनुमति देता है
Typical उपयोग के मामलों में स्पष्टता के लिए सामग्री का निर्माण कानूनी दस्तावेजों का अनुपालन शैक्षिक सामग्री का विकास SEO अनुकूलन और विज्ञापन पाठों के लिए A/B परीक्षण शामिल हैं API यह सुनिश्चित करने में मदद करती है कि पाठ आपकी लक्षित ऑडियंस के लिए पठनीयता मानकों को पूरा करते हैं
डेटा की सटीकता को स्थापित पठनीयता सूत्रों जैसे Flesch और Gunning Fog के उपयोग के माध्यम से बनाए रखा जाता है जो भाषाई अनुसंधान में व्यापक रूप से मान्यता प्राप्त हैं API के एल्गोरिदम को सुसंगत और विश्वसनीय पठनीयता मूल्यांकनों को प्रदान करने के लिए डिज़ाइन किया गया है
उपयोगकर्ता उच्च फ्लेश रीडिंग ईज स्कोर की अपेक्षा कर सकते हैं जो आसान पाठों को इंगित करते हैं जबकि निम्न स्कोर जटिलता को दर्शाते हैं इसके अतिरिक्त, औसत ग्रेड स्तर आमतौर पर पाठ की पठनीयता स्कोर से संबंधित होगा जो पाठ की कठिनाई की स्पष्ट समझ प्रदान करता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
820ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
645ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
939ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
854ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,311ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
314ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
9ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
596ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
269ms