edgepedia

Edgepedia

Edgepedia API

বিশ্বকোষের ৫,০০,০০০-এরও বেশি নিবন্ধ, আর সংখ্যাটি ক্রমেই বাড়ছে—সবই JSON-এ। বিনা মূল্যে। কোনো কী লাগে না, নিবন্ধনও নয়। কৃতিত্বস্বীকার করে বাণিজ্যিক ব্যবহার করা যায়। AI প্রশিক্ষণে সবার জন্য উন্মুক্ত।

ব্যবহার করে দেখুন

পড়ার রুটগুলিতে GET ব্যবহৃত হয়; মাইগ্রেশন, ব্যাচ এবং আপনার পাঠানো টেক্সটের জন্য ব্যবহৃত হয় POST। প্রতিটি রুট যেকোনো প্রোগ্রাম বা ওয়েব পেজকে JSON-এ উত্তর দেয় (CORS সব অরিজিনের অনুমতি দেয়)। যন্ত্রপাঠ্য বিবরণ: /openapi.json, প্রতিটি রুটের একটি করে নমুনা উত্তরসহ; একই বিবরণের OpenAPI 3.0 রূপ, মডেলের জন্য ফাংশন সংজ্ঞা, TypeScript টাইপ এবং রিকোয়েস্ট কালেকশন নিচের ‘তৈরি করা ফাইল’ অংশে তালিকাভুক্ত আছে।

রেফারেন্স কার্ড

থিম

নির্বাচিত: Cantor's diagonal argument

পূর্বরূপ

আপনার ওয়েবসাইটের জন্য একটি কার্ডে নিবন্ধের শিরোনাম, সম্পূর্ণ সারসংক্ষেপ এবং Edgepedia-র কৃতিত্বস্বীকার।

/embed/{id}?theme=auto কোনো নিবন্ধের ক্যানোনিক্যাল আইডি দিয়ে তার কার্ড সরবরাহ করে। চেহারা হতে পারে auto, light বা dark। ঐচ্ছিক /assets/edgepedia-embed.js স্ক্রিপ্টটি বিষয়বস্তু অনুযায়ী ফ্রেমের মাপ ঠিক করে; এটি না থাকলেও ফ্রেমটি পড়া ও স্ক্রল করা যায়।

/embed/{slug}-ও কাজ করে: থিম অপরিবর্তিত রেখে এটি নিবন্ধের আইডিতে থাকা কার্ডে রিডাইরেক্ট করে। Edgepedia একটি oEmbed প্রদানকারীও: GET /oembed?url={article or card URL}&format=json উপরের বিল্ডারের মতোই একই এমবেড কোড html হিসেবে ফেরত দেয়, সঙ্গে শিরোনাম, প্রস্থ ও উচ্চতা; maxwidth ও maxheight মেনে চলে। সাধারণ সংগ্রহের প্রতিটি নিবন্ধ-পৃষ্ঠার <head>-এ তার oEmbed ঠিকানার লিংক থাকে, তাই WordPress, Discourse ও অন্যান্য oEmbed গ্রাহক পেস্ট করা Edgepedia লিংককে কার্ডে রূপান্তর করে।

রুটসমূহ

রুটযা ফেরত দেয়
/api/v1/search?q=wordsশিরোনাম ও অন্যান্য নাম মেলায়, সবচেয়ে ভালো মিলগুলি আগে আসে। কোনো প্রশ্ন নয়, বিষয়টির নাম দিয়ে খুঁজুন। প্রতিটি ফলে থাকে: আইডি, শিরোনাম, শীর্ষস্তরের বিষয়, প্রিভিউ টেক্সট, লিংক এবং কীভাবে মিলেছে (match, confidence)। কোনো বিষয়ের নাম বোঝায় এমন শব্দ, যেমন "science fiction writers", দিলে topics-ও ফেরত আসে—সেই বিষয়ের নিবন্ধগুলির একটি লিংক। limit হলো প্রতি পাতায় ফলের সংখ্যা, ১ থেকে ৩০ (ডিফল্ট ১০); page দিয়ে পাতা বদলানো যায়, আর শেষের পরের পাতা ফাঁকা থাকে। অন্য নাম ও ভুল বানানও কাজ করে: "zhu yuanzhang" দিয়ে হংউ সম্রাটকে পাওয়া যায়, আর "siddartha" দিলে ফেরত আসে did_you_mean। আরও বিকল্প: নিচে ‘অনুসন্ধান’ অংশে।
/api/v1/articles/{slug}Markdown-এ নিবন্ধটি, বিষয়বৃক্ষে তার পথ, ভূগোলবৃক্ষে তার অবস্থানগুলি (geo), সর্বশেষ হালনাগাদের তারিখ এবং দেখানোর জন্য কৃতিত্বস্বীকারের পঙ্‌ক্তি। যেকোনো নাম কাজ করে (Mount_Fuji, কোনো শিরোনাম, একটি সম্পূর্ণ ঠিকানা), আর বিকল্পগুলি ব্যবহার করে একটি অংশ, রূপরেখা, পাঠাংশ বা অন্য রূপ পাওয়া যায়: নিচে ‘নিবন্ধ পড়া’ অংশে।
/api/v1/articles?id={id}একই তথ্য, আইডি দিয়ে। সংগ্রহ মাইগ্রেশনের পরেও পুরোনো নিবন্ধ-আইডি দিয়ে নিবন্ধ পাওয়া যায়; বৃক্ষটি সংশোধিত হলে বিষয়-আইডি বদলাতে পারে। কোনো ঠিকানা সরে যেতে পারে; পুরোনো ঠিকানাতেও উত্তর পাওয়া যায়, সঙ্গে থাকে moved_from। ids= একসঙ্গে সর্বাধিক ১০টি নেয়।
/api/v1/leads?ids={id},{id}আইডি দিয়ে সর্বাধিক ৫০টি নিবন্ধ, প্রতিটি অনুসন্ধান-ফলের আকারে (আইডি, শিরোনাম, শীর্ষস্তরের বিষয়, প্রিভিউ টেক্সট, লিংক)—এক পাতা কার্ডের জন্য। মাইগ্রেট বা একীভূত হওয়া আইডিগুলির ক্ষেত্রে অনুরোধ করা আইডিকে কী হিসেবে রেখে অবশিষ্ট নিবন্ধটি ফেরত দেয়; ফলের id-ই ক্যানোনিক্যাল। অজানা বা অনুপলব্ধ আইডি বাদ দেওয়া হয়।
/api/v1/randomদৈবচয়নে একটি নিবন্ধ। new=1 নতুনতম নিবন্ধগুলি থেকে বেছে নেয়; topic= বা geo= কোনো নোডের অধীন থেকে বেছে নেয়।
/api/v1/related/{slug}একটি কলেই কোনো নিবন্ধের প্রতিবেশী নিবন্ধগুলি: নিজস্ব বিষয়ে তার নিকটতম সর্বাধিক ১০টি, সর্বাধিক ৮টি প্রতিবেশী বিষয়ের প্রতিটি থেকে ৩টি এবং সেটি যে যে ভূগোল-নোডে আছে, তার প্রতিটিতে নিকটতম সর্বাধিক ১০টি। এ ছাড়াও ?id={id}। তার বদলে by=links দিলে সেটির সঙ্গে একত্রে উদ্ধৃত নিবন্ধগুলি পাওয়া যায়।
/api/v1/topicsবিষয়বৃক্ষের শীর্ষ।
/api/v1/topics/{id}কোনো বিষয়ের পথ, নিবন্ধের সংখ্যাসহ তার উপবিষয়গুলি এবং তার অধীন প্রতিটি নিবন্ধ, প্রতি পাতায় ৩০টি। format=mermaid তার উপবৃক্ষ আঁকে।
/api/v1/geoভূগোলবৃক্ষ: তার অঞ্চলগুলি, প্রতিটির সঙ্গে তার কালপর্বগুলি।
/api/v1/geo/{id}কোনো ভূগোল-নোড, বিষয়ের মতো একই গঠনে: তার পথ, আরও নির্দিষ্ট নোডগুলি এবং নিবন্ধগুলি, প্রতি পাতায় ৩০টি। কোনো অঞ্চলের ক্ষেত্রে শুধু তার কালপর্বগুলি তালিকাভুক্ত হয়।
POST /api/v1/ids/translatev1.5 মাইগ্রেশন সক্রিয় থাকলে: পাঠান {"ids":["old-id", "another-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: আইডি দিলে সেই বিষয়ের মূল বিষয়, আরও নির্দিষ্ট বিষয়গুলি এবং নিবন্ধগুলি তালিকাভুক্ত হয়, প্রতি page-এ ১২০টি; 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-এর গণনায় অন্তর্ভুক্ত হয়ে। টুলের ত্রুটি এমন টেক্সট যা মডেল পড়ে (যে আইডিতে কোনো নিবন্ধ নেই, তার জন্য did_you_mean আইডিসহ); তার কোড থাকে _meta["ai.edgechat/error"]-এ, কখনোই structuredContent-এ নয়। links: "in"-সহ fetch সেখানে লিংক দেয় এমন পরবর্তী ৩০টি নিবন্ধের জন্য links_page নেয়।

search নেয় limit (১ থেকে ৩০, ডিফল্ট ১০), page, first, topic ও sort, আর উত্তরে দেয় page ও pages; fetch নিচের নিবন্ধ-সংক্রান্ত বিকল্পগুলি নেয়, এবং একসঙ্গে একাধিকের জন্য নেয় ids। প্রতিটি ফলে থাকে canonical_id, নিবন্ধটির স্থায়ী আইডি: fetch এটি গ্রহণ করে, আর আপনার সংরক্ষিত কোনো আইডি বা ঠিকানা সরে গেলে, 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 উল্লেখ করা থাকে।

সীমা

প্রতি আইপি ঠিকানায় মিনিটে ৬০০টি এবং দিনে ১,০০,০০০টি অনুরোধ—API ও MCP সার্ভার, উভয়ের জন্যই। প্রতিটি উত্তরের RateLimit-Policy-এ দুটি সময়সীমার উল্লেখ থাকে। সীমা পেরোলে API, Retry-After ও RateLimit-সহ 429 উত্তর দেয়; MCP টুল কলের উত্তরে আসে টুলের ত্রুটি, যার retry_after-এ সেকেন্ডের সংখ্যা দেওয়া থাকে। প্রতিটি সার্ভার ইনস্ট্যান্সে আলাদা করে গণনা রাখা হয়, তাই এগুলি হুবহু ব্যবহারের মাপকাঠি নয়, বরং এমন ঊর্ধ্বসীমা যার নিচে থাকতে হবে। অনুগ্রহ করে ক্যাশ করুন। আইডি রূপান্তরের ক্ষেত্রে অনুরোধ করা প্রতিটি আইডি আলাদাভাবে গণনা করা হয়; পুরোনো আইডি পরীক্ষা করে যে /leads ব্যাচগুলি, সেগুলির হিসাবও প্রতিটি পুরোনো আইডি অনুযায়ী হয়। অন্যান্য ব্যাচে প্রতিটি আইডি বা নাম একটি অনুরোধ হিসেবে গণ্য হয়, আর annotate-এর ক্ষেত্রে প্রতি ১,০০০ অক্ষরে একটি।

লাইসেন্স

Edgepedia কমিউনিটি লাইসেন্স ১.০: কৃতিত্বস্বীকার করলে বিনা মূল্যে ব্যবহার করা যায়, বাণিজ্যিক ব্যবহারও অন্তর্ভুক্ত। AI প্রশিক্ষণ সবার জন্য উন্মুক্ত, আর মডেলের আউটপুটে কৃতিত্বস্বীকারের প্রয়োজন নেই। অন্য ব্যবহারের ক্ষেত্রে, যেসব প্রতিষ্ঠানের আয় ১০ কোটি মার্কিন ডলারের বেশি বা মাসিক ব্যবহারকারী ১০ কোটির বেশি, তাদের আলাদা লাইসেন্স নিতে হয়।

কৃতিত্বস্বীকার: প্রতিটি নিবন্ধের পাঠ যেখানেই দেখাবেন, সেখানেই তার 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 থাকে।

পরিবর্তন

সংস্করণ ১-এর গঠন অপরিবর্তিত থাকে: ফিল্ড যোগ হতে পারে, কিন্তু কখনো নাম বদলাবে না বা বাদ যাবে না। Edgepedia-র নিজস্ব পরিবর্তনগুলি আছে /edgepedia/updates-এ। কোনো রিলিজে বিষয়বৃক্ষ পুনর্বিন্যস্ত হলে, যেমন 1.8.0-তে হয়েছিল, সরে যাওয়া বিষয়-আইডি তার নতুন আইডিসহ 301 উত্তর দেয়, আর /api/v1/changes?since=<release> সেই রিলিজের পর থেকে যোগ হওয়া, বদলানো, সরে যাওয়া বা সরিয়ে ফেলা প্রতিটি নিবন্ধের তালিকা দেয়।

/api/v1 জানায় corpus_version, corpus_updated ও release_notes। এগুলি সাধারণ সংগ্রহের প্রকাশিত রিলিজ ও তার প্রকাশের তারিখ চিহ্নিত করে, প্রতিটি নিবন্ধের সর্বশেষ সম্পাদনার তারিখ নয়। একই মেটাডেটা MCP সার্ভারের নির্দেশনাতেও থাকে। সংগ্রহের রিলিজে API বা MCP সফটওয়্যারের সংস্করণ বদলায় না। সেখানকার id_policy জানায়, একটি আইডি কী নিশ্চয়তা দেয়: কোনো রিলিজে আইডির নম্বর বদলাতে পারে বা একাধিক আইডি একীভূত হতে পারে, যেমন 1.5-তে হয়েছিল, আর পুরোনো আইডিগুলি 308 ও POST /api/v1/ids/translate-এর মাধ্যমে উত্তর দিতে থাকে।

কিছু কাজ করছে না? জানান।

বিস্তারিত নির্দেশিকা

যেসব রুট ও ফিল্ড উদ্ভূত তথ্য (গুরুত্ব, পড়ার স্তর, লিংক, তারিখ, অন্য নাম এবং পূর্ণপাঠ সূচি) থেকে তথ্য পড়ে, সেগুলি সেই তথ্য স্টোরের সঙ্গে প্রকাশিত না হওয়া পর্যন্ত Retry-After-সহ 503 উত্তর দেয়, অথবা ফিল্ডটি বাদ রাখে।

নিবন্ধ পড়া

/api/v1/articles/{slug} ও MCP fetch এই বিকল্পগুলি গ্রহণ করে; এগুলি না দিলে উত্তরে সম্পূর্ণ নিবন্ধ পাওয়া যায়।

বিকল্পযা ফেরত দেয়
section={heading}শিরোনাম বা তার কোনো একটি শব্দ দিয়ে একটি অংশ, তার উপাংশগুলি-সহ (section=etymology দিয়ে "Name and 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) থেকে তৈরি একটি স্থিতিশীল আইডি এবং একটি cite_url।
q={words}&k={1–10}passages: শব্দগুলির সঙ্গে সবচেয়ে ভালো মেলে এমন k-টি অনুচ্ছেদ (ডিফল্ট ৩), প্রতিটির সঙ্গে একটি cite_url।
quote={sentence or chunk id}cite_url: টেক্সট ফ্র্যাগমেন্টসহ নিবন্ধের ঠিকানা, যা পৃষ্ঠাটি সেই পাঠাংশে খোলে; নিবন্ধে সেটি আছে কি না, তা জানায় quote_found।
cite={format}cite: নিবন্ধটির একটি তথ্যসূত্র, যেভাবে /api/v1/cite দেয়।

নিবন্ধের প্রতিটি উত্তরেই speakable থাকে (ভয়েস অ্যাসিস্ট্যান্ট পড়ে শোনাতে পারে এমন রূপে সংক্ষিপ্ত পাঠাংশটি)। importance ও rank (নিবন্ধগুলির মধ্যকার লিংকের ওপর PageRank; ১ হলো সবচেয়ে কেন্দ্রীয়; এটি লিংকের হিসাব, বিষয়টির মূল্যায়ন নয়), words, reading_grade (Flesch-Kincaid) এবং reading_minutes শুধু তখনই আসে, যখন fields=-এ সেগুলির নাম থাকে (?fields=title,importance,rank); MCP fetch-এ এগুলি সব সময়ই থাকে। next=1 এর পরে পড়ার জন্য সর্বাধিক ৫টি নিবন্ধ যোগ করে। MCP-র citations: false-এর মতোই, citations=false মূল পাঠের মধ্যে থাকা সূত্রের লিংকগুলির বদলে markdown, chunks ও passages-এ [n] চিহ্ন দেয়। কোনো নিবন্ধেরই নয় এমন ঠিকানাকে নিবন্ধের আইডি (/api/v1/articles/ep7rbwcy0a) হিসেবে, অথবা বড়-ছোট অক্ষর ও স্বরাঘাতচিহ্নের পার্থক্য উপেক্ষা করে তার শিরোনাম (/api/v1/articles/paris) হিসেবে পড়া হয়; ছোট হাতের অক্ষর ও হাইফেন দিয়ে গড়া কোনো ঠিকানা এর চেয়েও কম মিলে গেলে 404 আসে, যদি না আপনি ?suggest=1 যোগ করেন। অন্যদিকে, বড় হাতের অক্ষর, স্পেস বা আন্ডারস্কোর আছে এমন ঠিকানাকে (/api/v1/articles/Albert_Einstein) নাম হিসেবে পড়া হয়, তাই পুরোপুরি না মিললেও সবচেয়ে ভালো মেলা অনুসন্ধান-ফলটি resolved_by: search-সহ ফেরত আসে। আপনার দেওয়া নামটি নিবন্ধের ঠিকানা না হলে, উত্তরে জানানো হয় সেটিকে কী হিসেবে পড়া হয়েছে (resolved_from, resolved_by: ঠিকানা, শিরোনাম বা অনুসন্ধান) এবং অন্য ৩টি nearest নিবন্ধের তালিকা দেওয়া হয়। /api/v1/articles?ids={slug or id},{name} সর্বাধিক ১০টি ফেরত দেয় 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} সর্বাধিক ৫০টির জন্য একই কাজ করে। লেখক হিসেবে থাকে 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 সর্বাধিক ১,০০০টি মিলের প্রতিটিকে ছেঁকে দেখে, আর scope জানায় উত্তরটি কত দূর পর্যন্ত পৌঁছেছে।
sort=centralসর্বাধিক ১,০০০টি মিলের মধ্যে সবচেয়ে বেশি লিংক পাওয়া বিষয়গুলি আগে।
max_grade={grade}শুধু সেই পাঠস্তরের বা তার নিচের নিবন্ধগুলি।
facets=1সর্বাধিক ১,০০০টি মিলের সবগুলি ধরে শীর্ষস্তরের বিষয় ও ভৌগোলিক অঞ্চল অনুযায়ী মিলের সংখ্যা (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}সাধারণ সংগ্রহের প্রতিটি নিবন্ধ, একটি নির্দিষ্ট ক্রমে: {id, slug, title, api_url} ও next (শেষে null)। after= ফাঁকা রাখলে শুরু থেকে আরম্ভ হয়, আর যেকোনো আইডির পর থেকে আবার চালিয়ে যাওয়া যায়, এমনকি সরিয়ে ফেলা আইডির পর থেকেও।
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoসম্পূর্ণ বিষয়বৃক্ষ ও ভূগোলবৃক্ষ: nodes: [[id, label, parent index, own articles]]; বিন্দু দিয়ে শুরু হওয়া আইডি তার প্যারেন্ট নোডের আইডির পরের অংশ।
/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 হলো খ্রিস্টপূর্ব ৪৪ (প্রমিত ISO 8601 পার্সার এটিকে খ্রিস্টপূর্ব ৪৫ হিসেবে পড়বে)। বাক্যটিই প্রমাণ: তারিখটিকে তথ্য হিসেবে গ্রহণ করার আগে সেটি পড়ুন।
/api/v1/aliases/{id}নিবন্ধের অন্য নামগুলি, নিবন্ধে উল্লেখ করা আদ্যক্ষর-সংক্ষেপসহ ("NASA"); ভুল বানান ও বড়-ছোট অক্ষরের ভিন্ন রূপ বাদ দেওয়া হয়, আর একই নামের দুটি বানান থাকলে বিন্দুহীনটিই রাখা হয় ("WHO", "W.H.O." নয়)।

নাম শনাক্ত করা, টীকা যোগ করা ও তথ্য মেলানো

সাধারণ টেক্সট দিলে নিবন্ধের আইডি পাওয়া যায়, কোনো মডেল বা এমবেডিং ছাড়াই। annotate, classify ও geoparse-এ পাঠানো টেক্সট কখনো লগে লেখা বা সংরক্ষণ করা হয় না।

রুটযা ফেরত দেয়
/api/v1/resolve?name=Mercury&context=planetকোনো নাম দিয়ে সবচেয়ে সম্ভবত যে নিবন্ধটি বোঝানো হয়েছে: result, confidence, ambiguous, match (exact, alias, anchor, partial বা none) এবং alternatives। type= একটি বিষয়-আইডির অধীন সম্ভাব্য নিবন্ধগুলিই রাখে (নামটির প্রথম ৩০টি মিলের একটিও সেখানে না থাকলে, একক নামের ক্ষেত্রে পরের ৬০টিও খোঁজা হয়); limit= ১ থেকে ১০। POST সর্বাধিক ৫০টি নেয়: { "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": "…" } (সর্বাধিক ২০,০০০ অক্ষর): লিংক করা প্রতিটি শব্দবন্ধ, সঙ্গে তার অবস্থান-সূচক (start, end, UTF-16 কোড ইউনিটে, JavaScript যেভাবে স্ট্রিংয়ের সূচক গণনা করে: Python-এ Basic Multilingual Plane-এর বাইরের কোনো অক্ষর, যেমন ইমোজি, এখানে দুই হিসেবে গণ্য হয়), নিবন্ধ এবং মিলের নিশ্চয়তার মান। ?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/reconcileএকটি Reconciliation 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=যেসব নিবন্ধ এটিতে লিংক দেয়, প্রতি পাতায় ৩০টি, সবচেয়ে গুরুত্বপূর্ণগুলি আগে, তাদের অ্যাঙ্কর টেক্সটসহ।
/api/v1/path?from=&to=দুটি নিবন্ধের মধ্যে লিংকের সংক্ষিপ্ততম শৃঙ্খল (সর্বাধিক ৬ ধাপ, সম্ভব হলে বহু লিংকের কেন্দ্রগুলি এড়িয়ে), সঙ্গে প্রতিটি ধাপের সংযোগকারী বাক্য। MCP সার্ভারে এর নাম connect।
/api/v1/compare?a=&b=দুটি নিবন্ধ পাশাপাশি: সূচনা, বিষয়বৃক্ষে পথ, উভয়ের সবচেয়ে গভীর সাধারণ বিষয়, তাদের মধ্যকার শৃঙ্খল, সাধারণ ও নিজস্ব লিংক এবং প্রতিটির ‘মূল তথ্য’ সারণি।
/api/v1/graph/{slug}?depth=1|2&limit=তার সবচেয়ে গুরুত্বপূর্ণ প্রতিবেশীদের মধ্যে সর্বাধিক limitটি (ডিফল্ট ৫০, সর্বাধিক ২০০), এবং তাদের মধ্যকার প্রতিটি লিংক। complete: false (এখানে, backlinks-এ এবং rank/top-এ) বোঝায়, রুটটির জন্য নির্ধারিত প্রায় এক সেকেন্ড সময় ফুরিয়ে যাওয়ায় উত্তর সংক্ষিপ্ত করতে হয়েছে; এমন উত্তর মাত্র এক মিনিট ক্যাশে রাখা হয়।
POST /api/v1/context{ "ids": [...] }, সর্বাধিক ৫০টি আইডি বা ঠিকানা (/rank?ids= ও /leads?ids=-ও যেমন এগুলি নেয়): তাদের মধ্যকার লিংক, তাদের অধিকাংশের সঙ্গে লিংকে যুক্ত নিবন্ধগুলি, তাদের সবচেয়ে গভীর সাধারণ বিষয় ও স্থান এবং প্রতিটির সূচনা।
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=PageRank অনুযায়ী গুরুত্ব: গোটা সংগ্রহে pr-এর যোগফল ১, ক্রমে ১ হলো সবচেয়ে কেন্দ্রীয়। নামগুলি খেয়াল করুন: /search ও নিবন্ধে importance হলো এই ক্রমের ০ থেকে ১-এর মধ্যে পার্সেন্টাইল রূপ; /resolve-এর importance হলো সরাসরি pr-এর মান, আর /leads-এরটি হলো { pr, rank }।
/api/v1/timeline?topic=|geo=&from=&to=কোনো বিষয় বা স্থানের নিবন্ধগুলি থেকে তারিখসংবলিত বাক্য, প্রাচীনতমটি আগে, প্রতি পাতায় ৫০টি; খ্রিস্টপূর্বের বছর ঋণাত্মক। একটি নোড তার তারিখগুলি জুড়ে ছড়ানো সর্বাধিক ২০০টি ঘটনা রাখে, আর from ও to সেই নমুনাকে ছেঁকে নেয়; পূর্ণ হয়ে যাওয়া নমুনা থেকে নেওয়া উত্তরে sampled: true ও তার cap থাকে, আর তার total নমুনার সংখ্যা গণনা করে।
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}বছরের কোনো একটি দিনের ঘটনা (ডিফল্টভাবে UTC অনুযায়ী আজ), অথবা একটি বছরের ঘটনা (-9999 থেকে 2100)। এক দিনে সর্বাধিক ৫০০টি এবং এক বছরে ২,০০০টি ঘটনা থাকে; এই সীমা পূর্ণ হলে 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) নিবন্ধগুলি, প্রতি পাতায় ৩০টি; 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.jsonএকটি Arazzo 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)।