edgepedia

Edgepedia

Edgepedia API

विश्वकोश के 5,00,000 से अधिक लेख, और यह संख्या लगातार बढ़ रही है—JSON के रूप में। निःशुल्क। न किसी कुंजी की ज़रूरत, न पंजीकरण की। श्रेय देकर व्यावसायिक उपयोग की अनुमति। AI प्रशिक्षण सभी के लिए खुला है।

आज़माएँ

पढ़ने वाले रूट GET का उपयोग करते हैं; माइग्रेशन, बैच और आपके भेजे हुए पाठ के लिए POST का उपयोग होता है। हर रूट किसी भी प्रोग्राम या वेब पेज को JSON में उत्तर देता है (CORS हर ओरिजिन की अनुमति देता है)। मशीन-पठनीय विवरण: /openapi.json, जिसमें हर रूट के उत्तर का एक उदाहरण है; यही विवरण OpenAPI 3.0 में, मॉडलों के लिए फ़ंक्शन परिभाषाएँ, TypeScript टाइप और अनुरोध-संग्रह नीचे “जनरेट की गई फ़ाइलें” के अंतर्गत सूचीबद्ध हैं।

संदर्भ कार्ड

रंग-रूप

चुना गया: Cantor's diagonal argument

पूर्वावलोकन

आपकी वेबसाइट के लिए एक कार्ड में लेख का शीर्षक, पूरा सार और Edgepedia को श्रेय।

/embed/{id}?theme=auto किसी लेख की कैनॉनिकल ID के आधार पर उसका कार्ड उपलब्ध कराता है। रूप-सज्जा auto, light या dark हो सकती है। वैकल्पिक /assets/edgepedia-embed.js स्क्रिप्ट फ़्रेम को उसकी सामग्री के आकार के अनुसार ढाल देती है; इसके बिना भी फ़्रेम पढ़ने और स्क्रॉल करने योग्य रहता है।

/embed/{slug} भी काम करता है: यह थीम बरकरार रखते हुए लेख की ID वाले कार्ड पर रीडायरेक्ट करता है। Edgepedia एक oEmbed प्रदाता भी है: GET /oembed?url={article or card URL}&format=json ऊपर दिए गए बिल्डर वाला ही एम्बेड कोड html के रूप में लौटाता है, साथ में शीर्षक, चौड़ाई और ऊँचाई भी; maxwidth और maxheight का पालन किया जाता है। General के हर लेख-पृष्ठ के <head> में उसके oEmbed पते का लिंक होता है, इसलिए WordPress, Discourse और oEmbed का उपयोग करने वाले अन्य सिस्टम चिपकाए गए Edgepedia लिंक को कार्ड में बदल देते हैं।

रूट

रूटक्या लौटाता है
/api/v1/search?q=wordsशीर्षकों और अन्य नामों का मिलान करता है, सबसे सटीक परिणाम पहले। किसी विषय का नाम खोजें, प्रश्न नहीं। हर परिणाम में: id, शीर्षक, शीर्ष-स्तरीय विषय, पूर्वावलोकन पाठ, लिंक और मिलान का आधार (match, confidence)। किसी विषय को दर्शाने वाले शब्द, जैसे “science fiction writers”, topics भी लौटाते हैं, जो उसके लेखों का लिंक है। limit पृष्ठ का आकार है, 1 से 30 तक (डिफ़ॉल्ट 10); page से पृष्ठ बदले जाते हैं, और अंतिम पृष्ठ से आगे का पृष्ठ खाली होता है। अन्य नाम और ग़लत वर्तनियाँ भी काम करती हैं: “zhu yuanzhang” से होंगवू सम्राट मिलता है, और “siddartha” से did_you_mean लौटता है। अधिक विकल्प: नीचे “खोज” देखें।
/api/v1/articles/{slug}Markdown में लेख, उसका विषय-पथ, भूगोल-वृक्ष में उसके स्थान (geo), उसके अंतिम अद्यतन की तारीख़ और प्रदर्शित की जाने वाली श्रेय-पंक्ति। कोई भी नाम काम करता है (Mount_Fuji, कोई शीर्षक, कोई पूरा पता), और विकल्पों से कोई खंड, रूपरेखा, अंश या अन्य रूप लौटाए जा सकते हैं: नीचे “लेख पढ़ना” देखें।
/api/v1/articles?id={id}वही जानकारी, id के आधार पर। कॉर्पस माइग्रेशन के बाद भी लेखों की पुरानी id काम करती रहती हैं; वृक्ष में संशोधन होने पर विषयों की id बदल सकती हैं। कोई पता बदल सकता है; पुराना पता फिर भी moved_from के साथ उत्तर देता है। ids= एक साथ अधिकतम 10 लेता है।
/api/v1/leads?ids={id},{id}कार्डों का एक पृष्ठ बनाने के लिए id के आधार पर अधिकतम 50 लेख, हर एक खोज-परिणाम के रूप में (id, शीर्षक, शीर्ष-स्तरीय विषय, पूर्वावलोकन पाठ, लिंक)। माइग्रेट और मर्ज की गई id के लिए शेष बचा लेख लौटता है, जिसकी कुंजी अनुरोधित id होती है; परिणाम का id कैनॉनिकल होता है। अज्ञात या अनुपलब्ध id छोड़ दी जाती हैं।
/api/v1/randomकोई एक यादृच्छिक लेख। new=1 सबसे नए लेखों में से चुनता है; topic= या geo= किसी नोड के अंतर्गत चुनता है।
/api/v1/related/{slug}एक ही कॉल में किसी लेख के पड़ोसी लेख: उसके अपने विषय में उसके अधिकतम 10 निकटतम लेख, अधिकतम 8 पड़ोसी विषयों में से प्रत्येक के 3 लेख, और हर उस भूगोल नोड में उसके अधिकतम 10 निकटतम लेख जिसमें वह आता है। साथ में ?id={id} भी। इसके बजाय by=links वे लेख देता है जिन्हें उसके साथ उद्धृत किया गया है।
/api/v1/topicsविषय-वृक्ष का शीर्ष।
/api/v1/topics/{id}किसी विषय का पथ, लेखों की संख्या सहित उसके उपविषय, और उसके अंतर्गत आने वाला हर लेख, प्रति पृष्ठ 30। format=mermaid उसका उपवृक्ष आरेखित करता है।
/api/v1/geoभूगोल-वृक्ष: उसके क्षेत्र, हर क्षेत्र की कालावधियों सहित।
/api/v1/geo/{id}विषय की तरह संरचित एक भूगोल नोड: उसका पथ, अधिक विशिष्ट नोड और लेख, प्रति पृष्ठ 30। कोई क्षेत्र केवल अपनी कालावधियाँ सूचीबद्ध करता है।
POST /api/v1/ids/translatev1.5 माइग्रेशन सक्षम होने पर: {"ids":["old-id", "another-id"]} भेजें (अधिकतम 500 अलग-अलग id)। उत्तर में बदली हुई id को उनके शेष बचे कैनॉनिकल लेखों से मैप किया जाता है; अपरिवर्तित या अज्ञात id छोड़ दी जाती हैं। पूरे हो चुके बैचों के चेकपॉइंट सहेजें और Retry-After का पालन करें।

पूर्वावलोकन पाठ के लिए, उपलब्ध होने पर कॉर्पस का संक्षिप्त अंश लिया जाता है, अन्यथा लेख का आरंभ। जिन रिकॉर्डों और परिणामों में संक्षिप्त अंश होता है, उनमें वह snippet के रूप में भी शामिल रहता है; markdown में लेख का पूरा पाठ ही रहता है। node, जब मौजूद हो, लेख का वर्तमान अवधारणा-वृक्ष नोड होता है।

हर लेख अपने पते पर Markdown के रूप में भी उपलब्ध है। .md जोड़ें: www.edgepedia.org/koala.md।

MCP सर्वर

https://www.edgepedia.org/mcp। इसे Claude में कस्टम कनेक्टर के रूप में, Developer mode चालू करके ChatGPT में, एक क्लिक से VS Code या Cursor में, या इसके पते से किसी भी अन्य MCP क्लाइंट में जोड़ें। न किसी कुंजी की ज़रूरत, न साइन-इन की। केवल पढ़ने वाले पाँच टूल: search (किसी विषय का नाम देने पर उससे मेल खाते लेख, और यदि शब्द किसी विषय का नाम हों तो वह विषय भी), fetch (Markdown में एक लेख, उसकी श्रेय-पंक्ति, विषय-पथ और भूगोल सहित; लगभग एक-चौथाई छोटे पाठ के लिए citations: false; topic: id उस विषय का जनक विषय, अधिक विशिष्ट विषय और लेख सूचीबद्ध करती है, प्रति page 120; topic:root और topic:geo विषय-वृक्ष और भूगोल-वृक्ष के शीर्ष हैं), related (किसी लेख के अपने विषय, निकटवर्ती विषयों और भूगोल में उसके पड़ोसी लेख; उसके साथ उद्धृत लेखों के लिए by: "links"), connect (from, to: दो लेखों के बीच लिंक की शृंखला, उसी तरह जैसे /api/v1/path देता है), और resolve (name, साथ में वैकल्पिक context और type: वह लेख जिसकी ओर किसी नाम के संकेत करने की सबसे अधिक संभावना हो, उसी तरह जैसे /api/v1/resolve देता है)। जब किसी search से कोई शीर्षक मेल नहीं खाता, तो जिन लेखों का पाठ मेल खाता है वे शीर्षक-मिलानों के बाद आते हैं, उन पर match: fulltext का चिह्न होता है, वे limit की सीमा में रहते हैं और pages में गिने जाते हैं। टूल की त्रुटि एक पाठ होती है जिसे मॉडल पढ़ता है (किसी भी लेख की न होने वाली id के लिए did_you_mean id के साथ); उसका कोड _meta["ai.edgechat/error"] में आता है, कभी structuredContent में नहीं। links: "in" के साथ fetch, वहाँ लिंक करने वाले अगले 30 लेखों के लिए links_page लेता है।

search, limit (1 से 30, डिफ़ॉल्ट 10), page, first, topic और sort लेता है, और उत्तर में page तथा pages देता है; fetch नीचे दिए गए लेख-विकल्प और एक साथ कई लेखों के लिए ids लेता है। हर परिणाम में canonical_id होता है, जो लेख की स्थायी id है: fetch इसे स्वीकार करता है, और जब आपकी सहेजी हुई कोई id या पता बदल गया हो, तो fetch लेख लौटाते समय moved_from को आपके माँगे हुए मान पर सेट करता है। परिणामों में कॉर्पस रिलीज़ का नाम _meta.corpus_version में दिया जाता है। प्रोटोकॉल 2025-06-18 या उसके बाद के संस्करण पर चलने वाले क्लाइंट को प्रति लेख एक resource_link भी मिलता है।

संसाधन: edgepedia://article/{slug} (Markdown में लेख, वही पाठ जो fetch में है) और edgepedia://topic/{id} (किसी विषय के अधिक विशिष्ट विषय और लेख), दोनों के लिए स्वतः-पूर्णता सुविधा के साथ; स्वतः-पूर्णता किसी लेख का नाम लेने वाले हर आर्ग्युमेंट के लिए लेखों के शीर्षक भी सुझाती है। Agent Skill भी MCP पर (skills/list, skills/get), skill://edgepedia/SKILL.md के रूप में उपलब्ध है। /mcp पर GET करने से सर्वर कार्ड JSON में मिलता है। जो क्लाइंट केवल text/event-stream स्वीकार करते हैं, उन्हें हर उत्तर एक SSE message इवेंट के रूप में मिलता है। टूल-सूची का sha256 हर उत्तर के _meta (ai.edgechat/tools-sha256) में आता है, जिससे किसी टूल के विवरण में हुआ बदलाव दिखाई देता है।

Windows (पूर्वावलोकन, बिल्ड 26220.7262 या बाद का): odr.exe mcp add --uri https://www.edgepedia.org/mcp। बाकी हर क्लाइंट के लिए सेटअप पंक्तियाँ, एक Agent Skill और उदाहरण: github.com/EdgePlat/edgepedia-mcp।

MCP नहीं है, या क्लाइंट केवल पुराने SSE ट्रांसपोर्ट से काम करता है? अपने मॉडल को दो फ़ंक्शन दें जो /api/v1/search और /api/v1/articles/{slug} को कॉल करें, या /tools.json से उनके तैयार रूप ले लें। पुराने ट्रांसपोर्ट के पते (/sse, /mcp/sse) 404 उत्तर देते हैं, जिसकी बॉडी में https://www.edgepedia.org/mcp का नाम होता है।

सीमाएँ

प्रति IP पते पर एक मिनट में 600 अनुरोध और एक दिन में 1,00,000 अनुरोध—API और MCP सर्वर, दोनों के लिए। हर उत्तर RateLimit-Policy में दोनों समय-सीमाएँ बताता है। इनसे आगे API, Retry-After और RateLimit के साथ 429 उत्तर देता है; MCP टूल कॉल एक टूल त्रुटि लौटाती है, जिसका retry_after सेकंडों की संख्या बताता है। गिनती हर सर्वर इंस्टेंस पर अलग रखी जाती है, इसलिए ये ऐसी अधिकतम सीमाएँ हैं जिनके नीचे रहना चाहिए, न कि कोई सटीक मीटर। कृपया कैश करें। /ids/translate में हर अनुरोधित id अलग गिनी जाती है; पुरानी id की जाँच करने वाले /leads बैचों में भी हर पुरानी id अलग गिनी जाती है। अन्य बैचों में हर id या नाम एक अनुरोध गिना जाता है, और annotate के लिए हर 1,000 अक्षरों पर एक अनुरोध।

लाइसेंस

Edgepedia सामुदायिक लाइसेंस 1.0: श्रेय देने पर निःशुल्क, व्यावसायिक उपयोग सहित। AI प्रशिक्षण सभी के लिए खुला है, और मॉडल के आउटपुट में श्रेय देना आवश्यक नहीं है। अन्य उपयोगों के लिए, 10 करोड़ अमेरिकी डॉलर से अधिक राजस्व या 10 करोड़ से अधिक मासिक उपयोगकर्ताओं वाले संगठन अलग से लाइसेंस लें।

श्रेय: जहाँ भी आप किसी लेख का पाठ दिखाएँ, वहाँ उसकी credit पंक्ति उसके लिंक के साथ दिखाएँ। लेख के उत्तरों में यह चिपकाने के लिए तैयार रूप में credit_md और credit_html के तौर पर, तथा license.spdx (LicenseRef-Edgepedia-Community-1.0) भी मिलती है। API के लेख-उत्तरों और /leads के उत्तरों में Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" और X-License: LicenseRef-Edgepedia-Community-1.0 होते हैं।

EdgeChat ऐप, उसके Edge Apps और हमारे सॉफ़्टवेयर निःशुल्क हैं, लेकिन स्वामित्वाधीन हैं: कोई स्रोत कोड उपलब्ध नहीं कराया जाता, और उनकी प्रतिलिपि बनाने, उनमें संशोधन करने या उन्हें पुनर्वितरित करने की अनुमति नहीं है (EdgeChat लाइसेंस समझौता)।

त्रुटियाँ

JSON: { "error": { "code": "not_found", "message": "…" } }। 400 q अनुपस्थित, 404 नहीं मिला, 410 हटा दिया गया, 413 पाठ बहुत लंबा, 429 बहुत अधिक अनुरोध, 503 फिर प्रयास करें। 404 में अगली कॉल का विवरण होता है: hint, next (एक URL), और ऐसे लेख-पते के लिए जहाँ कुछ नहीं मिलता, तीन सबसे निकट शीर्षकों के साथ did_you_mean। MCP के fetch टूल की “नहीं मिला” त्रुटि में भी यही did_you_mean होता है।

बदलाव

संस्करण 1 की संरचना बनी रहती है: फ़ील्ड जोड़े जा सकते हैं, लेकिन उनके नाम कभी बदले नहीं जाते और न उन्हें हटाया जाता है। Edgepedia के अपने बदलाव /edgepedia/updates पर हैं। जब कोई रिलीज़ विषय-वृक्ष को पुनर्गठित करती है, जैसा 1.8.0 ने किया था, तो स्थानांतरित विषय की id अपनी नई id के साथ 301 उत्तर देती है, और /api/v1/changes?since=<release> उस रिलीज़ के बाद जोड़े गए, बदले गए, स्थानांतरित किए गए या हटाए गए हर लेख को सूचीबद्ध करता है।

/api/v1 में corpus_version, corpus_updated और release_notes दिए जाते हैं। ये प्रकाशित General-कॉर्पस रिलीज़ और उसकी रिलीज़ की तारीख़ की पहचान करते हैं, न कि हर लेख के अंतिम संपादन की तारीख़ की। यही मेटाडेटा MCP सर्वर के निर्देशों में भी दिखाई देता है। कॉर्पस रिलीज़ से API या MCP सॉफ़्टवेयर का संस्करण नहीं बदलता। वहाँ id_policy बताता है कि कोई id क्या भरोसा देती है: किसी रिलीज़ में id को नए नंबर दिए जा सकते हैं या मर्ज किया जा सकता है, जैसा 1.5 में हुआ था, और पुरानी id, 308 और POST /api/v1/ids/translate के ज़रिए, उत्तर देती रहती हैं।

कुछ काम नहीं कर रहा? रिपोर्ट करें।

संदर्भ

व्युत्पन्न डेटा (महत्त्व, पठन-स्तर, लिंक, तारीख़ें, अन्य नाम और पूर्ण-पाठ इंडेक्स) से जानकारी पढ़ने वाले रूट और फ़ील्ड, जब तक वह डेटा स्टोर के साथ प्रकाशित नहीं हो जाता, Retry-After के साथ 503 उत्तर देते हैं या उस फ़ील्ड को छोड़ देते हैं।

लेख पढ़ना

/api/v1/articles/{slug} और MCP fetch ये विकल्प स्वीकार करते हैं; इनके बिना उत्तर में पूरा लेख मिलता है।

विकल्पक्या लौटाता है
section={heading}किसी खंड का शीर्षक या उसका कोई शब्द देकर वह खंड, उसके उपखंडों सहित (section=etymology से “नाम और व्युत्पत्ति” मिलता है; section=lead आरंभिक भाग है)। अज्ञात शीर्षक पर लेख के sections के साथ 404 उत्तर मिलता है।
outline=1outline: हर शीर्षक, टोकन में उसके आकार सहित।
max_tokens={n}किसी खंड या अनुच्छेद की सीमा पर लगभग n टोकन तक काटा गया पाठ, tokens_estimate, truncated और next_cursor के साथ; शेष पाठ के लिए इसे उसी max_tokens के साथ cursor के रूप में भेजें।
length=snippet, length=leadपूरे पाठ की जगह संक्षिप्त अंश, या शीर्षक और आरंभिक अनुच्छेद।
format=text, html, jsonld, turtle, tablesसादे पाठ, रेंडर की गई बॉडी, या उसके सार्वजनिक फ़ील्ड के JSON-LD या Turtle के रूप में उत्तर; tables हर तालिका को columns और rows के रूप में, csv के रूप में, और उसके उद्धरणों को cites तथा sources में स्थानांतरित करके देता है।
chunks=1chunks: अनुच्छेदों के रूप में लेख, हर अनुच्छेद के साथ उसके शीर्षक-पथ (geology-2) से बनी एक स्थिर id और एक cite_url।
q={words}&k={1–10}passages: शब्दों से सबसे अधिक मेल खाने वाले k अनुच्छेद (डिफ़ॉल्ट 3), हर एक के साथ एक cite_url।
quote={sentence or chunk id}cite_url: लेख का पता, ऐसे टेक्स्ट फ़्रैगमेंट के साथ जो पृष्ठ को उसी अंश पर खोलता है; quote_found बताता है कि वह अंश लेख में मौजूद है या नहीं।
cite={format}cite: लेख का संदर्भ, उसी तरह जैसे /api/v1/cite देता है।

हर लेख के उत्तर में speakable भी होता है (संक्षिप्त अंश का ऐसा रूप जिसे वॉइस असिस्टेंट पढ़ सके)। importance और rank (लेखों के बीच के लिंक पर आधारित पेजरैंक; 1 सबसे केंद्रीय है; यह लिंकों की गिनती है, विषय का मूल्यांकन नहीं), words, reading_grade (फ़्लेश-किंकेड), और reading_minutes तभी आते हैं जब fields= में उनके नाम दिए गए हों (?fields=title,importance,rank); MCP fetch में ये हमेशा होते हैं। next=1 आगे पढ़ने के लिए अधिकतम 5 लेख जोड़ता है। citations=false, markdown, chunks और passages में पाठ के बीच दिए गए स्रोत-लिंकों की जगह [n] चिह्न देता है, उसी तरह जैसे MCP का citations: false देता है। जो पता किसी लेख का नहीं है, उसे लेख की id (/api/v1/articles/ep7rbwcy0a) या उसके शीर्षक के रूप में पढ़ा जाता है, बड़े-छोटे अक्षरों और उच्चारण-चिह्नों का भेद किए बिना (/api/v1/articles/paris); छोटे अक्षरों और हाइफ़न वाला कोई पता इससे कम सटीक हो, तो 404 उत्तर मिलता है, जब तक आप ?suggest=1 न जोड़ें। वहीं बड़े अक्षरों, स्पेस या अंडरस्कोर वाला पता (/api/v1/articles/Albert_Einstein) नाम के रूप में पढ़ा जाता है, इसलिए थोड़ा चूका हुआ नाम resolved_by: search के साथ सबसे अच्छा खोज-मिलान लौटाता है। जब आपका दिया हुआ नाम लेख का पता नहीं होता, तो उत्तर बताता है कि उसे कैसे पढ़ा गया (resolved_from, resolved_by: पता, शीर्षक या खोज), और 3 nearest अन्य लेख सूचीबद्ध करता है। /api/v1/articles?ids={slug or id},{name} अधिकतम 10 को articles के रूप में लौटाता है (हर एक के साथ वह नाम भी asked के रूप में होता है जिसके उत्तर में वह मिला है), और missing भी; हर विकल्प हर एक पर लागू होता है।

लेख का संदर्भ देना

/api/v1/cite/{slug}?format=, csl (CSL-JSON, डिफ़ॉल्ट), bibtex, ris, apa, mla, chicago या harvard में संदर्भ देता है, साथ में सादे पाठ, Markdown और HTML में श्रेय-पंक्ति भी; /api/v1/cite?ids={id},{slug} यही काम अधिकतम 50 के लिए करता है। लेखक Edgepedia (EdgeChat) है; APA, MLA, Chicago और Harvard में तिरछे अक्षरों वाले शीर्षक को तारक-चिह्नों से दर्शाया जाता है, जैसे Markdown में। संदर्भ प्रबंधकों के लिए संदर्भ कार्डों में भी यही उद्धरण अदृश्य रूप से COinS और JSON-LD में शामिल रहता है।

खोज

matchकबconfidence
exactशीर्षक ही खोज-पद है।ऐसे पहले परिणाम के लिए 1.0, बाद वाले के लिए 0.9
aliasकोई अन्य नाम, या शीर्षक के शुरुआती अक्षर ("mlk"), मेल खाते हैं।0.8; ऐसे पहले परिणाम के लिए 0.7 जिसमें खोज-पद का कोई शब्द नहीं है; लिप्यंतरित खोज-पद के लिए 0.6
misspellingखोज ने खोज-पद सुधारा है (did_you_mean)।0.5 × टाइप किए गए खोज-पद का वह अनुपात जो सुधार में बचा रहा
partialखोज-पद के कुछ शब्द शीर्षक में हैं, या केवल पाठ में हैं।0.2 + 0.5 × खोज-पद के शब्दों का वह अनुपात जो शीर्षक में है; केवल पाठ में होने पर 0.2
fulltextकोई शीर्षक या अन्य नाम मेल नहीं खाया, इसलिए लेखों के पाठ में खोज की गई (BM25): किसी विवरण से वह लेख मिलता है जिसका नाम आपको नहीं मालूम।कम-से-कम 0.2
noneकुछ भी मेल नहीं खाया। उत्तर खाली है।0

विश्वास-स्कोर एक तय नियम है, अंशांकित प्रायिकता नहीं; जिस उत्तर के सबसे अच्छे परिणाम का स्कोर 0.2 से नीचे हो, वह खाली लौटता है। हर परिणाम में highlight होता है, जो उसके सार का वह वाक्य है जिसमें खोज-पद के सबसे अधिक शब्द आते हैं। जिस खोज में कुछ नहीं मिलता, उसे लैटिन अक्षरों में एक बार फिर आज़माया जाता है (सिरिलिक, यूनानी, काना और हंगुल का लिप्यंतरण किया जाता है, पिनयिन की स्वराघात-संख्याएँ हटा दी जाती हैं, और रोमाजी के दोहरे स्वर छोटे कर दिए जाते हैं), और उत्तर में इसे searched_as कहा जाता है। चीनी अक्षरों का लिप्यंतरण नहीं किया जाता।

विकल्पक्या करता है
first=trueकेवल सबसे अच्छा मिलान, या कोई नहीं।
topic={id}, geo={id}केवल उस विषय या भूगोल नोड के अंतर्गत आने वाले लेख; geo अधिकतम 1,000 तक हर मिलान को फ़िल्टर करता है, और scope बताता है कि उत्तर का दायरा कहाँ तक है।
sort=centralअधिकतम 1,000 तक सभी मिलानों में, सबसे अधिक लिंक वाले विषय पहले।
max_grade={grade}केवल उस पठन-स्तर या उससे नीचे के लेख।
facets=1अधिकतम 1,000 तक सभी मिलानों की शीर्ष-स्तरीय विषय और भौगोलिक क्षेत्र के अनुसार गिनती (facets.counted)।

हर उत्तर

fields=a,b हर परिणाम की केवल उन्हीं कुंजियों को रखता है (या, जब उत्तर में परिणाम न हों, तो उत्तर की); बाहरी ढाँचा (total, page, next, license) बना रहता है। कैश किए जा सकने वाले 200 उत्तर में एक ETag होता है: उसे If-None-Match के रूप में वापस भेजें और उत्तर अपरिवर्तित होने पर बिना बॉडी का 304 मिलता है। Last-Modified कॉर्पस रिलीज़ की तारीख़ है और केवल जानकारी के लिए है। Edgepedia-Corpus-Version कॉर्पस रिलीज़ का नाम बताता है, और Content-Digest बॉडी का SHA-256 है (RFC 9530); लेख के .md में भी ये दोनों होते हैं।

और रूट

रूटक्या लौटाता है
/api/v1/articles?after={id}&limit={1..1000}General का हर लेख, एक तय क्रम में: {id, slug, title, api_url} और next (अंत में null)। after= खाली रखने पर शुरुआत से चलता है, और किसी भी id के बाद से क्रम फिर शुरू किया जा सकता है, हटाई गई id के बाद से भी।
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoपूरे विषय-वृक्ष और भूगोल-वृक्ष: nodes: [[id, label, parent index, own articles]]; बिंदु से शुरू होने वाली id अपने जनक की id को आगे बढ़ाती है।
/api/v1/releasesकॉर्पस रिलीज़, सबसे नई पहले, और current।
/api/v1/healthapplication/health+json: pass, warn या fail (503)।
/api/v1/manifestएक gzip JSONL फ़ाइल पर रीडायरेक्ट, जिसमें हर लेख के लिए एक पंक्ति है: { id, slug, title, updated, sha256, topic } (लेख के .md का sha256)। Edgepedia की मिरर प्रति बनाने के लिए इसे एक बार डाउनलोड करें। चेकसम पाठकों के सुधारों से पहले के प्रकाशित पाठ का है: रिलीज़ के बाद किसी पाठक के बताए सुधार से बदला हुआ लेख अगली रिलीज़ तक इससे मेल नहीं खाएगा।
/api/v1/changes?since={release}उस रिलीज़ से वर्तमान रिलीज़ तक की बदलाव-फ़ाइलें, क्रम से (फ़ीड 1.5 से शुरू होती है: since=1.5 सबसे पहली है); हर पंक्ति { op, id, … } होती है, जिसमें op का मान added, changed, moved (from_slug पुराना पता है), या removed में से एक होता है।
/api/v1/events/{slug}लेख के वे वाक्य जो कोई तारीख़ बताते हैं: { date, precision, text, para }, date को YYYY, YYYY-MM या YYYY-MM-DD के रूप में (ईसा पूर्व के लिए ऋणात्मक: -0044-03-15)। ईसा पूर्व की तारीख़ें ऐतिहासिक परंपरा का पालन करती हैं, खगोलीय वर्ष-गणना का नहीं: -0044 का अर्थ 44 ईसा पूर्व है (मानक ISO 8601 पार्सर इसे 45 ईसा पूर्व पढ़ेगा)। वाक्य ही साक्ष्य है: तारीख़ को तथ्य मानने से पहले उसे पढ़ें।
/api/v1/aliases/{id}लेख के अन्य नाम, जिनमें लेखों में दिए गए आद्याक्षरी संक्षेप ("NASA") भी शामिल हैं; ग़लत वर्तनियाँ और बड़े-छोटे अक्षरों के भेद वाले रूप छोड़ दिए जाते हैं, और एक नाम की दो वर्तनियाँ हों तो बिना बिंदु वाली रखी जाती है ("WHO", न कि "W.H.O.")।

नाम-निर्धारण, एनोटेशन और मिलान

मुक्त पाठ दें, लेखों की id पाएँ—बिना किसी मॉडल और बिना एम्बेडिंग के। annotate, classify और geoparse को भेजा गया पाठ न कभी लॉग किया जाता है, न सहेजा जाता है।

रूटक्या लौटाता है
/api/v1/resolve?name=Mercury&context=planetवह लेख जिसकी ओर किसी नाम के संकेत करने की सबसे अधिक संभावना हो: result, confidence, ambiguous, match (exact, alias, anchor, partial या none), और alternatives। type= संभावित मिलानों को एक विषय id के अंतर्गत सीमित रखता है (जब नाम के पहले 30 मिलानों में से कोई वहाँ न हो, तो एक नाम वाले अनुरोध के लिए अगले 60 भी देखे जाते हैं); limit= 1 से 10 तक। POST अधिकतम 50 लेता है: { "names": ["Paris", "Koala"] } या { "queries": [{ "name": "Mercury", "context": "planet" }] }। जब अकेले नाम से कोई एक लेख तय नहीं हो पाता, तो उत्तर ambiguous: true होता है, जिसमें सबसे अच्छा अनुमान result के रूप में दिया जाता है; चुनने के लिए context भेजें।
/api/v1/surface?form=mercuryवह हर लेख जिसकी ओर कॉर्पस के अपने लिंकों ने ठीक इसी वाक्यांश से संकेत किया है, लिंकों की गिनती और हर एक के हिस्से सहित (commonness)।
/api/v1/suggest?prefix=koaपहले ठीक उसी शीर्षक वाला लेख, फिर वह लेख जिसका कोई अन्य नाम ठीक मेल खाता हो, फिर दिए गए आरंभिक अंश से शुरू होने वाले शीर्षक, फिर ऐसे ही शुरू होने वाले अन्य नाम (matched वह नाम देता है)—खोज बॉक्स और वॉइस इंटरफ़ेस के लिए।
POST /api/v1/annotate{ "text": "…" } (अधिकतम 20,000 अक्षर): हर लिंक किया गया वाक्यांश, उसके ऑफ़सेट (start, end, UTF-16 कोड इकाइयों में, जैसे JavaScript स्ट्रिंग में इंडेक्स देता है: Python में बेसिक मल्टीलिंगुअल प्लेन से बाहर का कोई अक्षर, जैसे इमोजी, दो गिना जाता है), लेख और विश्वास-स्कोर सहित। ?format=html पाठ भी लौटाता है, HTML-एस्केप किए हुए रूप में, जिसमें हर वाक्यांश लिंक किया होता है।
POST /api/v1/classify{ "text": "…" }: पाठ जिन विषयों के बारे में है, उसमें उल्लिखित लेखों के विषय-पथों के आधार पर उनके स्कोर, और शीर्ष-स्तरीय हिस्से।
POST /api/v1/geoparse{ "text": "…" }: उसमें दिए गए स्थान और कालावधियाँ, भूगोल-वृक्ष पर (nodes, regions, places, periods); वृक्ष की गैर-भौगोलिक शाखा (geo.nongeo) कभी स्थान नहीं मानी जाती।
/api/v1/mentions?term=CRISPRऐसे लेख जो किसी विषय का उल्लेख करते हैं, लेकिन उसके लेख का लिंक नहीं देते; complete: false का अर्थ है कि लिंक देने वाले लेखों की सूची काट दी गई थी।
/api/v1/reconcileReconciliation Service API 0.2 का एक एंडपॉइंट: मैनिफ़ेस्ट, बैच queries (GET या POST), इकाई, प्रकार और गुण के सुझाव, पूर्वावलोकन और डेटा विस्तार (title, url, excerpt, topic, topic_path, importance_rank)। callback= के साथ JSONP। OpenRefine में: Reconcile › Start reconciling › Add standard service, और https://www.edgepedia.org/api/v1/reconcile चिपकाएँ।

लिंक ग्राफ़, तारीख़ें और सूचियाँ

आरेख (format=mermaid) Mermaid पाठ के रूप में होते हैं, ऐसे होस्ट के लिए जो उन्हें रेंडर कर सके।

रूटक्या लौटाता है
/api/v1/links/{slug}लेख से अन्य लेखों को जाने वाले लिंक, पढ़ने के क्रम में, हर एक के साथ उसका एंकर पाठ और वाक्य।
/api/v1/backlinks/{slug}?page=उसे लिंक करने वाले लेख, प्रति पृष्ठ 30, सबसे महत्त्वपूर्ण पहले, उनके एंकर पाठ सहित।
/api/v1/path?from=&to=दो लेखों के बीच लिंकों की सबसे छोटी शृंखला (अधिकतम 6 चरण, जहाँ संभव हो हब से बचते हुए), हर चरण को जोड़ने वाले वाक्य सहित। MCP सर्वर इसे connect कहता है।
/api/v1/compare?a=&b=दो लेख साथ-साथ: आरंभिक अंश, विषय-पथ, दोनों का सबसे गहरा साझा विषय, उनके बीच की शृंखला, साझा और अपने-अपने लिंक, और हर एक की मुख्य तथ्य तालिका।
/api/v1/graph/{slug}?depth=1|2&limit=उसके सबसे महत्त्वपूर्ण पड़ोसी लेखों में से अधिकतम limit (डिफ़ॉल्ट 50, अधिकतम 200), और उनके बीच का हर लिंक। complete: false (यहाँ, backlinks पर और rank/top पर) का अर्थ है कि रूट के लिए तय लगभग एक सेकंड की समय-सीमा के कारण उत्तर अधूरा रह गया; ऐसा उत्तर केवल एक मिनट के लिए कैश किया जाता है।
POST /api/v1/context{ "ids": [...] }, अधिकतम 50 id या पते (/rank?ids= और /leads?ids= भी इन्हें इसी रूप में लेते हैं): उनके बीच के लिंक, वे लेख जिनके साथ उनमें से अधिकांश का लिंक-संबंध है, उनका सबसे गहरा साझा विषय और स्थान, और हर एक का आरंभिक अंश।
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=पेजरैंक के अनुसार महत्त्व: पूरे कॉर्पस में pr का योग 1 होता है, रैंक 1 सबसे केंद्रीय है। नामों पर ध्यान दें: /search और लेखों में importance इसी रैंक का 0 से 1 के बीच का प्रतिशतक है; /resolve का importance मूल pr है, और /leads का { pr, rank } है।
/api/v1/timeline?topic=|geo=&from=&to=किसी विषय या स्थान के लेखों से तारीख़ वाले वाक्य, सबसे पुराने पहले, प्रति पृष्ठ 50; ईसा पूर्व के लिए वर्ष ऋणात्मक होते हैं। एक नोड अपनी तारीख़ों में फैली अधिकतम 200 घटनाएँ रखता है, और from तथा to उसी नमूने को फ़िल्टर करते हैं; अधिकतम सीमा तक भरे नमूने से लिए गए उत्तर में sampled: true और उसका cap होता है, और उसका total नमूने की गिनती बताता है।
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}वर्ष के किसी दिन की घटनाएँ (डिफ़ॉल्ट रूप से UTC के अनुसार आज), या किसी एक वर्ष की घटनाएँ (-9999 से 2100 तक)। किसी दिन में अधिकतम 500 घटनाएँ और किसी वर्ष में 2,000 होती हैं; अधिकतम सीमा तक भरे होने पर sampled: true दिया जाता है।
/api/v1/featured?date=, /api/v1/featured.xmlदिन का विशेष लेख (मुखपृष्ठ का “आज का तथ्य”), और पिछले दस दिनों की Atom फ़ीड।
/api/v1/list?topic=|geo=&period=&type=personकिसी विषय के, या किसी स्थान और कालावधि (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE) के लेख, प्रति पृष्ठ 30; type=person केवल व्यक्तियों को रखता है। भूगोल सूची की पंक्तियों में geo होता है और id नहीं होता (उसके लिए लेख प्राप्त करें)।
/api/v1/keyterms?topic=|geo=&limit=किसी उपवृक्ष के शीर्षक और अन्य नाम, वाक्-पहचान प्रणाली को पहले से तैयार करने के लिए।
/api/v1/stats?topic=|geo=&by=periodकेवल गिनती: कॉर्पस या किसी नोड और उसके सीधे अधीनस्थ नोड के लेख, लिंक और अन्य नाम। यहाँ articles अलग-अलग लेखों को गिनता है; /geo और /trees/geo पर यह सूची में उनके स्थानों को गिनता है, इसलिए किसी क्षेत्र की दो कालावधियों में आने वाला लेख वहाँ दो बार गिना जाता है।

खोज-सुविधाएँ और अन्य प्रोटोकॉल

जनरेट की गई फ़ाइलें

ये /openapi.json से बनाई जाती हैं, इसलिए उससे कभी अलग नहीं पड़तीं।

फ़ाइलक्या है
/openapi-3.0.jsonवही विवरण OpenAPI 3.0.3 में, उन टूल के लिए जो 3.1 नहीं पढ़ सकते।
/arazzo.jsonArazzo 1.0 का एक कार्यप्रवाह: खोजें, सबसे अच्छा मिलान प्राप्त करें, फिर उससे संबंधित लेख।
/tools.jsonहर JSON रूट, ऐसे फ़ंक्शन के रूप में जिसे मॉडल कॉल कर सके—OpenAI, Anthropic और Gemini प्रारूपों में, और उसके रूट सहित JSON Schema के रूप में भी।
/edgepedia.d.tsहर उत्तर और हर रूट के पैरामीटर के लिए TypeScript टाइप।
/edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.httpPostman, Bruno, Insomnia और VS Code या JetBrains के लिए हर रूट के अनुरोध का एक उदाहरण।

कृपया एक User-Agent भेजें जिसमें आपके प्रोग्राम का नाम हो, जैसा इन कलेक्शन में है (edgepedia-collection/1)।