{"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/12900/legal+compliance+readability+api/25679/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/12900/legal+compliance+readability+api/25680/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."}'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए कानूनी अनुपालन पठनीयता API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
(वार्षिक बिलिंग के साथ 2 महीने बचाएँ 🎉)
## यह क्या करता है
किसी भी अंग्रेजी पाठ या URL की पठनीयता स्कोर करता है। 5 उद्योग-मानक पठनीयता स्कोर, क्रियाशील सामान्य अंग्रेजी सुझाव, कठिन वाक्यों के झंडे के साथ वाक्य-स्तर का ब्रेकडाउन और वैकल्पिक लक्ष्य ग्रेड पास/फेल लौटाता है
## लौटाए गए स्कोर
- **फ्लेच रीडिंग ईज** — 0–100। अधिक = पढ़ने में आसान
- **फ्लेच-किंकेड ग्रेड** — अमेरिकी स्कूल ग्रेड के समकक्ष
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष
- **स्वचालित पठनीयता इंडेक्स (एआरआई)** — वर्ण/शब्द अनुपात के माध्यम से ग्रेड स्तर
- **स्मॉग इंडेक्स** — बहु-व्यंजन शब्द घनत्व के माध्यम से ग्रेड स्तर
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, एडटेक, एसईओ उपकरण, सीएमएस पाइपलाइन, ए/बी कॉपी परीक्षण
## एंडपॉइंट्स
- `POST /api/analyze` — पाठ या URL का विश्लेषण करें, वैकल्पिक लक्ष्य ग्रेड के साथ
- `POST /api/compare` — दो पाठों की तुलना करें एक ही साथ
एंडपॉइंट `POST /api/analyze` पठनीयता स्कोर सुझाव वाक्य का विवरण और एक वैकल्पिक लक्षित ग्रेड परिणाम लौटाता है एंडपॉइंट `POST /api/compare` दो पाठों की एक विस्तृत तुलना प्रदान करता है जिसमें उनके पठनीयता स्कोर ग्रेड स्तर और यह संक्षेप कि कौन सा पाठ पढ़ने में आसान है शामिल है
`analyze` प्रतिक्रिया में प्रमुख क्षेत्रों में `textStats` (शब्द, वाक्य, वर्ण गणना), `scores` (विभिन्न पठनीयता मीट्रिक्स), `overall` (औसत ग्रेड स्तर और निर्णय), और `suggestions` शामिल हैं `compare` प्रतिक्रिया में `text_a` और `text_b` क्षेत्र होते हैं जिनके अपने-अपने स्कोर और एक `comparison` सारांश होता है
अंतिम बिंदु `POST /api/analyze` ऐसे पैरामीटर स्वीकार करता है जैसे कि विश्लेषण के लिए पाठ या URL और मूल्यांकन के लिए एक वैकल्पिक रेटिंग अंतिम बिंदु `POST /api/compare` की तुलना के लिए दो पाठों की आवश्यकता होती है उपयोगकर्ता अपने अनुरोधों को विभिन्न पाठों या URL प्रदान करके अनुकूलित कर सकते हैं
प्रतिक्रियाओं के डेटा को JSON प्रारूप में संरचित किया गया है `विश्लेषण` में `सफलता` `पाठ_की_संख्याएँ` `अंक` `सामान्य` `सुझाव` और `वाक्यों का विघटन` के लिए खंड शामिल हैं `तुलना` की प्रतिक्रिया में `सफलता` `पाठ_ए` `पाठ_बी` और `तुलना` के खंड होते हैं जो विशिष्ट जानकारी तक पहुंच को आसान बनाते हैं
विशिष्ट उपयोग के मामलों में सामग्री टीमों द्वारा दस्तावेज़ स्पष्टता में सुधार करना कानूनी/अनुपालन टीमों द्वारा अनुबंधों की पठनीयता सुनिश्चित करना शैक्षिक सामग्री का आकलन करने के लिए EdTech अनुप्रयोग और वेब सामग्री अनुकूलित करने के लिए SEO उपकरण शामिल हैं एपीआई प्रतिलिपि प्रभावशीलता के लिए A/B परीक्षण में भी मदद करता है
उपयोगकर्ता अपने लक्षित दर्शकों के लिए पाठ की जटिलता को समायोजित करने के लिए पठनीयता स्कोर का लाभ उठा सकते हैं उदाहरण के लिए यदि किसी दस्तावेज़ का फ्लेश-किनकेड ग्रेड पर स्कोर बहुत उच्च है तो उपयोगकर्ता दिए गए सुझावों के आधार पर भाषा को सरल कर सकते हैं वाक्य विभाजन जटिल वाक्यों की पहचान करने और उन्हें संशोधित करने में मदद करता है
एपीआई स्थापित पठनीयता के सूत्रों का उपयोग करती है जो एक सुसंगत और विश्वसनीय अंकेक्षण सुनिश्चित करती है प्रत्येक सूत्र भाषाई अनुसंधानों पर आधारित है और एपीआई का डिज़ाइन वास्तविक समय में विश्लेषण की अनुमति देता है विभिन्न प्रकारों और लंबाई के पाठ के माध्यम से सटीकता बनाए रखते हुए
उपयोगकर्ता अपेक्षा कर सकते हैं कि पठनीयता के स्कोर पाठ की जटिलता के अनुसार भिन्न होंगे उदाहरण के लिए छोटे पाठ कम विश्वसनीय स्कोर दे सकते हैं जबकि लंबे पाठ (100 से अधिक शब्द) अधिक सटीक मूल्यांकन प्रदान करते हैं एपीआई जटिल वाक्य इंगित करता है जिससे उपयोगकर्ताओं को सुधार के लिए क्षेत्रों की पहचान करने में मदद मिलती है