edgepedia

Edgepedia

API Edgepedia

Понад 500 000 енциклопедичних статей у форматі JSON — і їх постійно більшає. Безплатно. Без ключа й реєстрації. Комерційне використання — із зазначенням авторства. Навчання ШІ відкрите для всіх.

Спробуйте

Маршрути для читання використовують 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 враховуються. Кожна сторінка статті з розділу «Загальні» містить посилання на свою адресу oEmbed у <head>, тож WordPress, Discourse та інші споживачі oEmbed перетворюють вставлене посилання Edgepedia на картку.

Маршрути

МаршрутЩо повертає
/api/v1/search?q=wordsЗбіги з назвами та іншими найменуваннями, найточніші — першими. Шукайте за назвою предмета, а не за запитанням. Кожен результат містить ідентифікатор, назву, тему верхнього рівня, текст для попереднього перегляду, посилання та спосіб знаходження збігу (match, confidence). Слова, що позначають тему, як-от «письменники-фантасти», також повертають 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}Те саме, за ідентифікатором. Старі ідентифікатори статей і далі працюють після міграції корпусу; ідентифікатори тем можуть змінюватися під час перегляду дерева. Адреса може змінитися; стара й далі повертає відповідь із moved_from. ids= приймає до 10 за раз.
/api/v1/leads?ids={id},{id}До 50 статей за ідентифікаторами, кожну у вигляді результату пошуку (ідентифікатор, назва, тема верхнього рівня, текст для попереднього перегляду, посилання), для сторінки карток. Для ідентифікаторів, змінених під час міграції або об’єднання, повертається стаття, що залишилася, із запитаним ідентифікатором як ключем; id у результаті є канонічним. Невідомі або недоступні ідентифікатори пропускаються.
/api/v1/randomОдну випадкову статтю. new=1 обирає з найновіших статей; topic= або geo= — з-під заданого вузла.
/api/v1/related/{slug}Сусідні зі статтею матеріали за один виклик: до 10 найближчих у її власній темі, по 3 з кожної з не більш ніж 8 сусідніх тем і до 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/translateЯкщо міграцію v1.5 увімкнено: надішліть {"ids":["old-id", "another-id"]} (до 500 різних ідентифікаторів). Відповідь зіставляє змінені ідентифікатори з канонічними ідентифікаторами статей, що залишилися; незмінені або невідомі ідентифікатори пропускаються. Зберігайте контрольні точки після завершення пакетів і дотримуйтеся Retry-After.

Для попереднього перегляду використовується фрагмент із корпусу, якщо він є, а інакше — початок статті. Записи та результати з таким фрагментом також містять його як snippet; markdown і далі містить повний текст статті. node, якщо є, — це поточний вузол статті в дереві понять.

Кожна стаття також доступна у форматі Markdown за власною адресою. Додайте .md: www.edgepedia.org/koala.md.

Сервер MCP

https://www.edgepedia.org/mcp. Додайте його до Claude як власний конектор, до ChatGPT з увімкненим режимом розробника, до VS Code чи Cursor одним натисканням або до будь-якого іншого клієнта MCP за адресою. Без ключа й входу в обліковий запис. П’ять інструментів лише для читання: search (на вході — назва предмета, на виході — відповідні статті, а також тема, якщо введені слова її позначають), fetch (одна стаття у форматі Markdown із рядком зазначення авторства, шляхом у дереві тем і географією; citations: false — для тексту приблизно на чверть коротшого; ідентифікатор topic: повертає батьківську тему, вужчі теми та статті цієї теми, по 120 на 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. fetch із links: "in" приймає links_page для наступних 30 статей, що посилаються сюди.

search приймає limit (від 1 до 30, типово 10), 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} (вужчі теми та статті певної теми), з автодоповненням для обох; автодоповнення також пропонує назви статей для будь-якого аргументу, що позначає статтю. Навичка агента теж надається через MCP (skills/list, skills/get) як skill://edgepedia/SKILL.md. Запит GET до /mcp повертає картку сервера у форматі 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. Рядки налаштування для всіх інших клієнтів, навичка агента та приклади: 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.

Обмеження

600 запитів на хвилину та 100 000 на добу з однієї IP-адреси — як для API, так і для сервера MCP. Кожна відповідь вказує обидва часові вікна в RateLimit-Policy. Після перевищення лімітів API повертає 429 із Retry-After і RateLimit; виклик інструмента MCP повертає помилку інструмента, у якій retry_after вказує кількість секунд. Лічильники ведуться окремо для кожного екземпляра сервера, тож це верхня межа, якої слід дотримуватися, а не точний вимірювач. Будь ласка, використовуйте кешування. Перетворення ідентифікаторів (/ids/translate) враховує кожен запитаний ідентифікатор окремо; пакети /leads, які перевіряють старі ідентифікатори, також враховуються за кожним старим ідентифікатором. В інших пакетах кожен ідентифікатор чи найменування рахується як один запит, а в анотуванні — один запит на кожні 1000 символів.

Ліцензія

Ліцензія спільноти Edgepedia 1.0: безплатно із зазначенням авторства, зокрема для комерційного використання. Навчання ШІ відкрите для всіх, а результати роботи моделі не потребують зазначення авторства. Для інших видів використання організації з доходом понад 100 мільйонів доларів США або понад 100 мільйонами користувачів на місяць отримують окрему ліцензію.

Зазначення авторства: показуйте рядок 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, змінений ідентифікатор теми повертає 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.

Щось не працює? Повідомте про це.

Довідка

Маршрути й поля, що використовують похідні дані (важливість, рівні складності читання, посилання, дати, інші найменування та повнотекстовий індекс), повертають 503 із Retry-After або не включають відповідне поле, доки ці дані не буде опубліковано разом зі сховищем.

Читання статті

/api/v1/articles/{slug} і MCP fetch приймають наведені нижче параметри; без них відповідь містить усю статтю.

ПараметрЩо повертає
section={heading}Один розділ за його заголовком або словом із нього (section=etymology знаходить «Назва та етимологія»; section=lead — це вступна частина), разом із підрозділами. Невідомий заголовок повертає 404 із sections статті.
outline=1outline: усі заголовки з розміром відповідних частин у токенах.
max_tokens={n}Текст, обрізаний приблизно до n токенів на межі розділу чи абзацу, з tokens_estimate, truncated і next_cursor; щоб отримати решту, передайте його як cursor із тим самим max_tokens.
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 абзаців (типово 3), що найкраще відповідають заданим словам, кожен із cite_url.
quote={sentence or chunk id}cite_url: адресу статті з текстовим фрагментом, що відкриває сторінку на відповідному уривку; quote_found вказує, чи містить його стаття.
cite={format}cite: бібліографічне посилання на статтю в тому вигляді, як його повертає /api/v1/cite.

Кожна відповідь зі статтею також містить speakable (фрагмент у формі, придатній для озвучення голосовим помічником). importance і rank (PageRank за посиланнями між статтями; 1 — найцентральніша стаття; це підрахунок посилань, а не оцінка предмета), words, reading_grade (Флеша — Кінкейда) та reading_minutes надходять лише тоді, коли їх перелічено в fields= (?fields=title,importance,rank); MCP fetch містить їх завжди. next=1 додає до 5 статей для подальшого читання. citations=false замінює вбудовані посилання на джерела позначками [n] у markdown, chunks і passages, як це робить citations: false у MCP. Адреса, якої не має жодна стаття, тлумачиться як ідентифікатор статті (/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 фільтрує всі збіги, щонайбільше 1000, а scope указує межі охоплення відповіді.
sort=centralПредмети, на які найбільше посилаються, — першими, серед усіх збігів, щонайбільше 1000.
max_grade={grade}Лише статті із заданим або нижчим рівнем складності читання.
facets=1Кількість збігів за темами верхнього рівня та географічними регіонами серед усіх збігів, щонайбільше 1000 (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Переспрямування на один файл JSONL, стиснений gzip, по рядку на статтю: { id, slug, title, updated, sha256, topic } (sha256 від .md статті). Завантажте його один раз, щоб створити дзеркало 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.»).

Визначення статей, анотування та узгодження

На вході — довільний текст, на виході — ідентифікатори статей, без моделі й векторних вкладень. Текст, надісланий для анотування, класифікації та географічного розбору, ніколи не записується до журналів і не зберігається.

МаршрутЩо повертає
/api/v1/resolve?name=Mercury&context=planetСтаттю, яку найімовірніше позначає найменування: result, confidence, ambiguous, match (exact, alias, anchor, partial або none) і alternatives. type= залишає кандидатів під одним ідентифікатором теми (якщо жоден із перших 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/reconcileКінцеву точку Reconciliation Service API 0.2: маніфест, пакетні queries (GET або POST), підказки сутностей, типів і властивостей, попередній перегляд та розширення даних (title, url, excerpt, topic, topic_path, importance_rank). JSONP з callback=. В 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 (тут, у зворотних посиланнях і в rank/top) означає, що відповідь обрізано через вичерпання відведеного маршруту часу — близько секунди; така відповідь кешується лише на хвилину.
POST /api/v1/context{ "ids": [...] }, до 50 ідентифікаторів або адрес (які також приймають /rank?ids= і /leads?ids=): посилання між ними, статті, з якими пов’язана посиланнями найбільша їх кількість, найглибшу спільну тему й місце та вступну частину кожної.
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=Важливість за PageRank: сума pr для всього корпусу дорівнює 1, ранг 1 має найцентральніша стаття. Зверніть увагу на назви: importance у /search і статтях — це цей ранг у вигляді процентиля від 0 до 1; importance у /resolve — це необроблене значення 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 подій, а рік — 2000; якщо досягнуто цієї межі, відповідь містить 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.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.httpПо одному прикладу запиту до кожного маршруту для Postman, Bruno, Insomnia та VS Code або JetBrains.

Будь ласка, надсилайте User-Agent із назвою вашої програми, як у цих колекціях (edgepedia-collection/1).