## यह क्या करता है
किसी भी अंग्रेजी पाठ या URL की पठनीयता को स्कोर करता है। 5 उद्योग मानक पठनीयता स्कोर, कार्यात्मक साधारण अंग्रेजी सुझाव, सबसे कठिन वाक्यों के साथ वाक्य-स्तरीय विभाजन और वैकल्पिक लक्ष्य ग्रेड पास/फेल लौटाता है।
## लौटाए गए स्कोर
- **फ्लेश रीडिंग ईज़** — 0–100। उच्च = पढ़ना आसान।
- **फ्लेश-किन्केड ग्रेड** — अमेरिकी स्कूल ग्रेड समकक्ष।
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष।
- **ऑटोमेटेड रीडेबिलिटी इंडेक्स (ARI)** — वर्ण/शब्द अनुपात द्वारा ग्रेड स्तर।
- **SMOG इंडेक्स** — बहु-स्वरित शब्द घनत्व द्वारा ग्रेड स्तर।
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, EdTech, 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/12903/technical+writing+readability+api/25683/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/12903/technical+writing+readability+api/25684/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` अंत बिंदु दो पाठों का साइड बाय साइड तुलना प्रदान करता है जिसमें उनके पठनीयता स्कोर ग्रेड स्तर और यह संक्षेप में बताया गया है कि कौन सा पाठ पढ़ने में आसान है
मुख्य क्षेत्र में `success`, `textStats` (शब्दों, वाक्यों और अक्षरों की गिनती), `scores` (विभिन्न पठनीयता मेट्रिक्स), `overall` (औसत ग्रेड स्तर और निर्णय), `suggestions` और `sentenceBreakdown` शामिल हैं विस्तृत विश्लेषण के लिए
एंडपॉइंट `POST /api/analyze` पाठ या विश्लेषण करने के लिए URL और मूल्यांकन के लिए एक वैकल्पिक लक्ष्य रेटिंग स्वीकार करता है एंडपॉइंट `POST /api/compare` की तुलना के लिए दो पाठों की आवश्यकता होती है उपयोगकर्ता विभिन्न पाठों या URLs प्रदान करके अनुरोधों को अनुकूलित कर सकते हैं
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है शीर्ष स्तर की कुंजी सफलतानुमा स्थिति को इंगित करती है उसके बाद टेक्स्ट सांख्यिकी पठनीयता स्कोर समग्र मूल्यांकन सुझाव और वाक्य विभाजन के लिए नेस्टेड ऑब्जेक्ट होते हैं जिससे इसे पार्स करना और उपयोग करना आसान हो जाता है
सामान्य उपयोग के मामले में सामग्री बनाना दस्तावेजों को सरल बनाना शैक्षिक सामग्री का मूल्यांकन करना एसईओ अनुकूलन और विपणन प्रतियों के लिए ए/बी परीक्षण शामिल हैं जिससे टीमों को यह सुनिश्चित करने में मदद मिलती है कि उनकी संचार प्रभावी और सुलभ है
उपयोगकर्ता पठनीयता स्कोर का लाभ उठाकर जटिल वाक्यों की पहचान कर सकते हैं और पाठ की स्पष्टता में सुधार कर सकते हैं सुझाव समीक्षाओं में मार्गदर्शन कर सकते हैं जबकि वाक्य के विवरण विशेष क्षेत्रों की पहचान करने में मदद करते हैं जिन्हें सरल बनाने की आवश्यकता है जिससे संचार की कुल गुणवत्ता में सुधार होता है
एपीआई स्थापित पठनीयता फार्मूलों का उपयोग करता है जो लगातार और विश्वसनीय स्कोरिंग सुनिश्चित करता है नियमित अपडेट और विभिन्न पाठ नमूनों के खिलाफ परीक्षण सटीकता और प्रासंगिकता बनाए रखने में मदद करते हैं पठनीयता आकलनों में प्रदान की गई
उपयोगकर्ता 0 से 100 तक की पठनीयता स्कोर की एक श्रृंखला की उम्मीद कर सकते हैं जिसमें उच्च स्कोर अधिक सरल पठनीयता को इंगित करते हैं औसत ग्रेड स्तर सामान्यतः 1 से 12 के बीच होता है जो पाठ को समझने के लिए आवश्यक शैक्षणिक स्तर को दर्शाता है जिससे पाठ की जटिलता का त्वरित मूल्यांकन किया जा सके
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
255ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,560ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
5,965ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,255ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
850ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
144ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,054ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,434ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,171ms