## यह क्या करता है
किसी भी अंग्रेजी पाठ या यूआरएल की पढ़ने की योग्यता का स्कोर करें। 5 उद्योग-मानक पढ़ने की योग्यताओं के स्कोर, कार्रवाई योग्य सरल अंग्रेजी सुझाव, सबसे कठिन वाक्यों को चिह्नित करते हुए वाक्य स्तर का ब्रेकडाउन और वैकल्पिक लक्ष्य ग्रेड पास/फेल लौटाता है।
## लौटाए गए स्कोर
- **Flesch Reading Ease** — 0–100। उच्च = पढ़ने में आसान।
- **Flesch-Kincaid Grade** — अमेरिकी स्कूल ग्रेड के समान।
- **Gunning Fog Index** — समझने के लिए आवश्यक शिक्षा के वर्ष।
- **Automated Readability Index (ARI)** — वर्ण/शब्द अनुपात के माध्यम से ग्रेड स्तर।
- **SMOG Index** — बहु-आवृत्ति वाले शब्द घनत्व के माध्यम से ग्रेड स्तर।
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, EdTech, SEO उपकरण, CMS पाइपलाइंस, 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/12901/edtech+readability+improvement+api/25681/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/12901/edtech+readability+improvement+api/25682/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` एंडपॉइंट दो पाठों की समानांतर तुलना करता है जिसमें उनके पठनीयता स्कोर, ग्रेड स्तर और यह संक्षेप में कि कौन सा पाठ पढ़ने में आसान है शामिल है
`analyze` की प्रतिक्रिया में मुख्य फ़ील्ड शामिल हैं `textStats` (शब्दों, वाक्यों और वर्णों की गणना), `scores` (विभिन्न पठनीयता मीट्रिक), `overall` (औसत ग्रेड स्तर और निर्णय), और `suggestions` `compare` की प्रतिक्रिया में फ़ील्ड शामिल हैं `text_a` और `text_b` उनके संबंधित स्कोर के साथ और एक सारांश `comparison`
प्रतिक्रिया के डेटा को JSON प्रारूप में संरचित किया गया है `विश्लेषण` के लिए इसमें सांख्यिकी के लिए अनुभाग शामिल हैं पाठ की रेटिंग समग्र मूल्यांकन सुझाव और वाक्य का विश्लेषण `तुलना` की प्रतिक्रिया में प्रत्येक पाठ की रेटिंग के लिए अलग-अलग अनुभाग और तुलना का एक सारांश होता है
`POST /api/analyze` एन्डपॉइंट टेक्स्ट या URL का विश्लेषण करने के लिए पैरामीटर स्वीकार करता है और एक वैकल्पिक लक्ष्य ग्रेड भी होता है `POST /api/compare` एन्डपॉइंट की तुलना के लिए दो टेक्स्ट की आवश्यकता होती है उपयोगकर्ता विभिन्न टेक्स्ट या URLs प्रदान करके अपने अनुरोध को कस्टमाइज़ कर सकते हैं
पारंपरिक उपयोग के मामले में शैक्षणिक सामग्री के लिए सामग्री का निर्माण कानूनी दस्तावेजों का सरलीकरण एसईओ का अनुकूलन और मार्केटिंग की प्रति के लिए ए/बी परीक्षण शामिल हैं एपीआई यह सुनिश्चित करने में मदद करता है कि सामग्री लक्षित दर्शकों के लिए सुलभ और उपयुक्त हो
उपयोगकर्ता लक्षित दर्शकों के अनुसार सामग्री की जटिलता को समायोजित करने के लिए पठनीयता स्कोर का लाभ उठा सकते हैं सुझाव समीक्षाओं का मार्गदर्शन कर सकते हैं जबकि वाक्यों का विभाजन सुधार के लिए विशिष्ट क्षेत्रों की पहचान करने में मदद करता है तुलना की सुविधा दो पाठों में से सबसे पठनीय विकल्प का चयन करने में मदद करती है
एपीआई स्थापित पठनीयता सूत्रों का उपयोग करता है जिससे स्थायी और विश्वसनीय स्कोरिंग सुनिश्चित होती है नियमित अपडेट और विभिन्न पाठ नमूनों के खिलाफ परीक्षण सटीकता और पठनीयता आकलनों में प्रासंगिकता बनाए रखने में मदद करते हैं
उपयोगकर्ता 0 से 100 के बीच विभिन्न पठनीयता अंक की उम्मीद कर सकते हैं जिनमें उच्च अंक आसान पठनीयता को संकेत करते हैं ग्रेड स्तर आमतौर पर प्रारंभिक से उन्नत तक भिन्न होते हैं जो पाठ की जटिलता को दर्शाते हैं सुझाव अक्सर सुधार के क्षेत्रों को उजागर करते हैं विशेष रूप से छोटे पाठों में
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
516ms
सर्विस लेवल:
99%
रिस्पॉन्स टाइम:
23ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
278ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,043ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,160ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
151ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
173ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
5,418ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,641ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
137ms