API Edgepedia
Более 500 000 энциклопедических статей в формате JSON, и их число постоянно растёт. Бесплатно. Без ключа и регистрации. Коммерческое использование — с указанием авторства. Обучение ИИ доступно всем.
Попробуйте
- www.edgepedia.org/api/v1/search?q=koala
- www.edgepedia.org/api/v1/articles/koala
- www.edgepedia.org/api/v1/random
- www.edgepedia.org/api/v1/topics
Маршруты для чтения используют 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 учитываются. На каждой странице статьи корпуса General адрес oEmbed указан в <head>, поэтому WordPress, Discourse и другие системы с поддержкой oEmbed превращают вставленную ссылку Edgepedia в карточку.
Маршруты
| Маршрут | Что возвращает |
|---|---|
/api/v1/search?q=words | Совпадения по заголовкам и другим названиям, начиная с наиболее подходящих. Ищите по названию предмета, а не по вопросу. Каждый результат содержит: id, заголовок, тему верхнего уровня, текст предпросмотра, ссылки и сведения о том, как найдено совпадение (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} | То же самое, по id. Старые идентификаторы статей продолжают работать после миграции корпуса; идентификаторы тем могут меняться при пересмотре дерева. Адрес может измениться; прежний по-прежнему возвращает ответ, с moved_from. ids= принимает до 10 за раз. |
/api/v1/leads?ids={id},{id} | До 50 статей по id, каждую в виде поискового результата (id, заголовок, тема верхнего уровня, текст предпросмотра, ссылки), для страницы с карточками. Для перенесённых и объединённых идентификаторов возвращается сохранившаяся статья, с запрошенным id в качестве ключа; поле 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, если запрошенный id не принадлежит ни одной статье); её код передаётся в _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 которой указано время в секундах. Счётчики ведутся для каждого экземпляра сервера отдельно, поэтому это верхние границы, которых следует придерживаться, а не точный учёт. Пожалуйста, кешируйте ответы. При преобразовании идентификаторов каждый запрошенный id учитывается отдельно; пакеты /leads, проверяющие старые идентификаторы, также учитываются по каждому старому id. В остальных пакетах каждый id или название считается одним запросом, а при аннотировании один запрос приходится на каждые 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. Эти данные обозначают опубликованный выпуск корпуса General и дату его выхода, а не дату последнего редактирования каждой статьи. Те же метаданные приведены в инструкциях 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=1 | outline: все заголовки с размером каждого раздела в токенах. |
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=1 | chunks: статью в виде абзацев, каждый со стабильным id, полученным из пути заголовков (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} | Все статьи General при обходе в фиксированном порядке: {id, slug, title, api_url} и next (null в конце). Пустое значение after= начинает обход с начала; продолжить обход можно после любого id, даже удалённого. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | Деревья тем и географии целиком: nodes: [[id, label, parent index, own articles]]; идентификатор, начинающийся с точки, продолжает идентификатор родительского узла. |
/api/v1/releases | Выпуски корпуса, начиная с самого нового, и current. |
/api/v1/health | application/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 (здесь, в backlinks и в 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 — размещения, поэтому статья, входящая в два периода одного региона, там учитывается дважды. |
Обнаружение и другие протоколы
- Карточка MCP-сервера: /.well-known/mcp/server-card.json (также
/mcp/server-card): название, конечная точка, инструменты и версии — без подключения. Конфигурация для реестра:/.well-known/mcp/config-schema.jsonи/.well-known/mcp/examples.json. - Каталог ИИ: /.well-known/ai-catalog.json: все способы доступа (MCP, этот API, A2A, NLWeb и навык агента) с примерами запросов.
- Каталог API: /.well-known/api-catalog — набор ссылок по RFC 9727, указывающий на этот API, его описание и эту документацию.
- Навык агента: /.well-known/agent-skills/index.json содержит
SKILL.mdс его контрольной суммой sha256. - OpenSearch: /opensearch.xml добавляет Edgepedia в список поисковых систем.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessageи 0.3message/send; карточка — по адресу/.well-known/agent-card.json). По названию предмета возвращаются пять лучших статей; по адресу статьи — сама статья в Markdown со строкой указания авторства. Ответ всегда представляет собой сообщение, а не задачу; те же методы доступны по адресу/mcp. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET либо POST с телом в формате JSON или формы) возвращает ответ в формате списка NLWeb: по одному объекту schema.orgschema_objectна результат;streaming=trueпередаёт список в виде событий SSE. Модель не вызывается. - Машиночитаемые представления статьи: по её адресу возвращается представление, указанное в заголовке
Accept:text/markdown(с оценкойx-markdown-tokens),application/json(ответ этого API) илиapplication/ld+json; при любом другом значении возвращается страница. Страницы статей содержат заголовокLinkсо ссылками на эти представления, лицензию, каталог API и описание OpenAPI.
Генерируемые файлы
Создаются на основе /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).