## यह क्या करता है
किसी भी अंग्रेजी पाठ या यूआरएल की पठनीयता को स्कोर करें। 5 उद्योग-मानक पठनीयता स्कोर, क्रियाशील सरल-इंग्लिश सुझाव, सबसे कठिन वाक्यों के साथ वाक्य-स्तरीय विभाजन और वैकल्पिक लक्षित ग्रेड पास/फेल लौटाता है।
## लौटाए गए स्कोर
- **फ्लेश रीडिंग ईज़** — 0–100। उच्च = पढ़ने में आसान।
- **फ्लेश-किन्केड ग्रेड** — अमेरिकी स्कूल ग्रेड समकक्ष।
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष।
- **ऑटोमेटेड पठनीयता इंडेक्स (ARI)** — अक्षर/शब्द अनुपात के माध्यम से ग्रेड स्तर।
- **SMOG इंडेक्स** — बहु-व्यंजक शब्द घनत्व के माध्यम से ग्रेड स्तर।
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, एजुकेशन टेक्नोलॉजी, 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/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."}'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
`POST /api/analyze` अंत बिंदु पढ़ने की क्षमता स्कोर सुझाव वाक्य विभाजन और एक वैकल्पिक लक्ष्य ग्रेड परिणाम देता है दिए गए पाठ या URL के लिए `POST /api/compare` अंत बिंदु दो पाठों की सामर्थ्य की तुलना प्रदान करता है जिसमें उनके फ्लेश स्कोर ग्रेड स्तर और यह सारांश कि कौन सा पाठ पढ़ने में आसान है शामिल है
`analyze` के उत्तर में मुख्य क्षेत्र शामिल हैं `textStats` (शब्दों, वाक्यों और वर्णों की गणना) `scores` (पार कई पठनीयता मेट्रिक्स) `overall` (औसत ग्रेड स्तर और निर्णय) `suggestions` और `sentenceBreakdown` `compare` के उत्तर में `text_a` और `text_b` के क्षेत्र शामिल हैं उनके संबंधित स्कोर के साथ और एक सारांश `comparison`
एंडपॉइंट `POST /api/analyze` `text` (विश्लेषण करने के लिए सामग्री) `url` (प्राप्त करने और विश्लेषण करने के लिए URL) और एक वैकल्पिक `targetGrade` को उत्तीर्ण/अउत्तीर्ण के मूल्यांकन के लिए स्वीकार करता है एंडपॉइंट `POST /api/compare` की तुलना करने के लिए दो पाठ की आवश्यकता होती है
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है `analyze` के लिए इसमें पाठ सांख्यिकी पढ़ने के स्कोर समग्र मूल्यांकन सुझाव और वाक्य विश्लेषण के लिए अनुभाग शामिल हैं `compare` के लिए यह प्रत्येक पाठ के स्कोर के लिए अलग-अलग अनुभाग और तुलना का सारांश प्रस्तुत करता है
टिपिकल उपयोग के मामले में पठनीयता के अनुकूलन के लिए सामग्री का निर्माण कानूनी दस्तावेजों को सरल बनाना शैक्षिक सामग्री का आकलन SEO सामग्री का आकलन और मार्केटिंग की प्रतियों के लिए A/B परीक्षण शामिल हैं API यह सुनिश्चित करने में मदद करता है कि सामग्री निर्धारित दर्शकों के लिए सुलभ हो
उपयोगकर्ता लक्षित दर्शकों के आधार पर सामग्री की जटिलता को समायोजित करने के लिए पढ़ने की योग्यता स्कोर का उपयोग कर सकते हैं सुझाव संशोधन के लिए मार्गदर्शन कर सकते हैं जबकि वाक्य विभाजन जटिल वाक्यों की पहचान में मदद करते हैं जिन्हें सरल बनाने की आवश्यकता हो सकती है तुलना सुविधा दो पाठों के बीच अधिक पढ़ने योग्य विकल्प चुनने में मदद करती है
एपीआई स्थापित पठनीयता सूत्रों का उपयोग करते हुए भाषाई सिद्धांतों के आधार पर एक स्थिर अंकन सुनिश्चित करती है नियमित अपडेट और विभिन्न पाठ नमूनों के खिलाफ परीक्षण प्रदान की गई अंकन में सटीकता और विश्वसनीयता बनाए रखने में मदद करते हैं
उपयोगकर्ता उम्मीद कर सकते हैं कि फ्लेश पढ़ने की आसानी के लिए स्कोर 0 से 100 के बीच होंगे जिसमें उच्च स्कोर आसान पठनीयता को दर्शाते हैं ग्रेड स्तर आमतौर पर अमेरिका के स्कूल ग्रेड के साथ मेल खाते हैं और सुझाव अक्सर विशेष रूप से छोटे पाठों के लिए सुधार के लिए क्षेत्रों को उजागर करते हैं
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
151ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
868ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
278ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
816ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
849ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,334ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,938ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
198ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,581ms