## यह क्या करता है
किसी भी अंग्रेजी पाठ या URL की पठनीयता का स्कोर करता है। 5 उद्योग-मानक पठनीयता स्कोर, कार्यक्षम साधारण अंग्रेजी सुझाव, सबसे कठिन वाक्यों के साथ वाक्य स्तर का टूटना और वैकल्पिक लक्ष्य ग्रेड उत्तीर्ण/असफल लौटाता है
## लौटाए गए स्कोर
- **फ्लेश रीडिंग ईज़** — 0–100। अधिक = पढ़ने में आसान
- **फ्लेश-किनकेड ग्रेड** — अमेरिकी स्कूल ग्रेड समकक्ष
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष
- **स्वचालित पठनीयता सूचकांक (एआरआई)** — वर्ण/शब्द अनुपात के माध्यम से ग्रेड स्तर
- **SMOG इंडेक्स** — बहु-स्वर्यवाले शब्द घनत्व के माध्यम से ग्रेड स्तर
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, शिक्षण तकनीक, एसईओ उपकरण, सीएमएस पाइपलाइन, ए/बी कॉपी परीक्षण
## एंडपॉइंट्स
- `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/12896/readability+api/25667/analyze' --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/12896/readability+api/25669/compare' --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` एन्डपॉइंट दो पाठों की साइड-बाय-साइड तुलना प्रदान करता है जिसमें उनके पठनीयता स्कोर ग्रेड स्तर और यह सारांश कि कौन सा पाठ पढ़ने में आसान है शामिल है
प्रतिक्रिया में मुख्य क्षेत्र शामिल हैं `सफलता` `पाठ सांख्यिकी` (शब्द, वाक्य, वर्ण गणना) `स्कोर` (फ्लेश, गुनिंग फॉग आदि) `कुल` (औसत ग्रेड स्तर और निर्णय) `सुझाव` और `वाक्य Breakdown` विस्तृत विश्लेषण के लिए
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है इसमें एक शीर्ष-स्तरीय सफलता संकेतक होता है इसके बाद पाठ सांख्यिकी पढ़ने की स्कोर समग्र मूल्यांकन सुधार के लिए सुझाव और व्यक्तिगत वाक्यों का विवरण होता है
`POST /api/analyze` एंडपॉइंट उन मानदंडों को स्वीकार करता है जैसे कि विश्लेषण के लिए पाठ या यूआरएल और पास/फेल मूल्यांकन के लिए एक वैकल्पिक लक्षित ग्रेड `POST /api/compare` एंडपॉइंट की तुलना के लिए दो पाठों की आवश्यकता होती है
उपयोगकर्ता विशिष्ट पाठ या विश्लेषण के लिए URL प्रदान करके और `POST /api/analyze` एंडपॉइंट में एक लक्षित ग्रेड स्तर सेट करके अनुरोधों को कस्टमाइज़ कर सकते हैं यह उपयोगकर्ता की आवश्यकताओं के आधार पर अनुकूलित पठनीयता आकलन की अनुमति देता है
विशिष्ट उपयोग के मामलों में ब्लॉग के लिए सामग्री निर्माण कानूनी दस्तावेजों की सरलीकरण शैक्षिक सामग्री विकास SEO अनुकूलन और विपणन सामग्री के लिए A/B परीक्षण शामिल हैं ताकि स्पष्टता और पहुंच सुनिश्चित किया जा सके
डेटा की सटीकता को स्थापित पठनीयता सूत्रों जैसे फ्लेश-किंकेड और गन्निंग फॉग के उपयोग के माध्यम से बनाए रखा जाता है जो भाषाविज्ञान अनुसंधान में व्यापक रूप से पहचाने जाते हैं एपीआई जटिल वाक्यों को भी चिन्हित करता है ताकि उपयोगकर्ता सुधार के लिए क्षेत्रों की पहचान कर सकें
यदि इनपुट पाठ बहुत छोटा है (100 शब्दों से कम), तो एपीआई सुझाव दे सकता है कि परिणाम कम विश्वसनीय हैं उपयोगकर्ताओं को अधिक सटीक पठनीयता स्कोर और अंतर्दृष्टि प्राप्त करने के लिए लंबे पाठों का लक्ष्य रखना चाहिए
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
816ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,407ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
516ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
86ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
853ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
527ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
151ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
290ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,938ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,340ms