## यह क्या करता है
किसी भी अंग्रेज़ी पाठ या यूआरएल की पठनीयता का स्कोर करता है। 5 उद्योग-मानक पठनीयता स्कोर, कार्यान्वयन योग्य सरल-अंग्रेज़ी सुझाव, सबसे कठिन वाक्यों को चिह्नित करते हुए वाक्य-स्तरीय विभाजन, और वैकल्पिक लक्ष्य ग्रेड पास/फेल लौटाता है।
## लौटाए गए स्कोर
- **फ्लेश पढ़ने की आसानी** — 0–100। अधिक = पढ़ने में आसान।
- **फ्लेश-किंकैड ग्रेड** — अमेरिका के स्कूल ग्रेड के बराबर।
- **गनिंग फॉग इंडेक्स** — समझने के लिए आवश्यक शिक्षा के वर्ष।
- **स्वचालित पठनीयता सूचकांक (एआरआई)** — वर्ण/शब्द अनुपात के माध्यम से ग्रेड स्तर।
- **SMOG इंडेक्स** — बहु-व्यक्तिक शब्द घनत्व के माध्यम से ग्रेड स्तर।
## उपयोग के मामले
सामग्री टीमें, कानूनी/अनुपालन, एजुकेशन टेक्नोलॉजी, एसईओ उपकरण, सीएमएस पाइपलाइंस, ए/बी कॉपी परीक्षण।
## एंडपॉइंट्स
- `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/12902/seo+optimization+readability+api/25677/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/12902/seo+optimization+readability+api/25678/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` अंत बिंदु दो पाठों की बगल-बगल तुलना प्रदान करता है जिसमें उनके पठनीयता स्कोर ग्रेड स्तर और यह सारांश कि कौन सा पाठ पढ़ने में आसान है शामिल हैं
प्रतिक्रिया में प्रमुख क्षेत्रों में `शब्दगणना` `वाक्यगणना` `स्कोर` (जो विभिन्न पठनीयता मेट्रिक्स包含 करता है) `सुझाव` और विस्तृत विश्लेषण के लिए `वाक्य विभाजन` शामिल हैं प्रत्येक स्कोर में `स्कोर` मान और `व्याख्या` शामिल होती है
एंडपॉइंट `POST /api/analyze` विश्लेषण करने के लिए पाठ या URL और एक वैकल्पिक लक्ष्यमूल्य स्वीकार करता है एंडपॉइंट `POST /api/compare` की तुलना करने के लिए दो पाठों की आवश्यकता होती है उपयोगकर्ता विभिन्न पाठ या URL प्रदान करके अनुरोधों को कस्टमाइज़ कर सकते हैं
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है इसमें एक `success` बूलियन शामिल है इसके बाद विस्तृत सांख्यिकी जैसे `textStats` `scores` `overall` `suggestions` और `sentenceBreakdown` शामिल हैं जिससे उपयोगकर्ता परिणामों को आसानी से एक्सेस और व्याख्या कर सकते हैं
प्रयुक्त मामलों में सामान्यत: SEO के लिए सामग्री का अनुकूलन शामिल है कानूनी दस्तावेजों को समझने योग्य बनाना EdTech में शैक्षिक सामग्री को बेहतर बनाना और मार्केटिंग की प्रतियों के लिए A/B परीक्षण करना एपीआई विभिन्न प्रकार की सामग्री में पठनीयता में सुधार करने में मदद करती है
डेटा की सटीकता स्थापित पठनीयता सूत्रों जैसे फ्लेश रीडिंग ईज़ और गनिंग फॉग इंडेक्स के उपयोग के माध्यम से बनाए रखी जाती है ये सूत्र भाषाई अनुसंधान पर आधारित हैं और उद्योग में व्यापक रूप से मान्यता प्राप्त हैं जो विश्वसनीय परिणामों की सुनिश्चितता करते हैं
उपयोगकर्ता उम्मीद कर सकते हैं कि पढ़ने के स्कोर 0 से 100 के बीच भिन्न होंगे जिनमें उच्च स्कोर आसान पढ़ने को दर्शाते हैं ग्रेड स्तर आमतौर पर अमेरिका के स्कूल ग्रेड के साथ मेल खाते हैं जो पाठ की जटिलता की स्पष्ट समझ प्रदान करते हैं
उपयोगकर्ता स्पष्टीकरण को बेहतर बनाने के लिए सुझावों का उपयोग करते हुए विशेष दर्शकों के लिए सामग्री को अनुकूलित करने के लिए पठनीयता स्कोर का लाभ उठा सकते हैं वाक्यों का विभाजन जटिल वाक्यों की पहचान में मदद करता है जिससे सामान्य पठनीयता में सुधार के लिए विशिष्ट समीक्षाओं की अनुमति मिलती है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
11,333ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,632ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,604ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
816ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
278ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,451ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
151ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms