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 учитываются. На каждой странице статьи корпуса 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=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: статью в виде абзацев, каждый со стабильным 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/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 (здесь, в 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 — размещения, поэтому статья, входящая в два периода одного региона, там учитывается дважды.

Обнаружение и другие протоколы

Генерируемые файлы

Создаются на основе /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).