edgepedia

Edgepedia

Edgepedia API

50万件を超え、今も増え続ける百科事典の記事をJSONで。無料。APIキーも登録も不要。クレジットを表示すれば商用利用も可能。AIの学習には、誰でも利用できます。

試してみる

読み取り用のルートはGETを、移行、バッチ処理、テキストの送信にはPOSTを使います。どのルートも、あらゆるプログラムやウェブページにJSONを返します(CORSはすべてのオリジンを許可しています)。機械可読の仕様は/openapi.jsonにあり、すべてのルートのレスポンス例を含みます。同じ仕様のOpenAPI 3.0版、モデル用の関数定義、TypeScriptの型定義、リクエストコレクションは、下の「生成ファイル」に掲載しています。

参照カード

外観

選択中:Cantor's diagonal argument

プレビュー

記事のタイトル、要約の全文、Edgepediaのクレジットを、ウェブサイトに掲載できるカードにまとめます。

/embed/{id}?theme=autoは、記事の正規IDを指定するとカードを返します。外観はauto、light、darkから選べます。任意で/assets/edgepedia-embed.jsスクリプトを使うと、フレームのサイズが内容に合わせて調整されます。使わない場合も、フレーム内は読み取りとスクロールが可能です。

/embed/{slug}も使えます。テーマを維持したまま、その記事のIDに対応するカードへリダイレクトします。EdgepediaはoEmbedプロバイダーでもあります。GET /oembed?url={article or card URL}&format=jsonは、上のビルダーと同じ埋め込みコードをhtmlとして、タイトル、幅、高さとともに返します。maxwidthとmaxheightの指定も反映されます。「一般」コレクションのすべての記事ページには、<head>内にoEmbedのアドレスへのリンクがあるため、WordPress、DiscourseなどのoEmbed対応サービスでは、貼り付けたEdgepediaのリンクがカードに変換されます。

ルート

ルート返される内容
/api/v1/search?q=wordsタイトルや別名に一致する記事を、一致度の高い順に返します。質問ではなく、調べたい対象の名前を検索してください。各結果には、ID、タイトル、最上位トピック、プレビューテキスト、リンク、一致の種類(match、confidence)が含まれます。「science fiction writers」のようにトピックを表す語では、そのトピックの記事へのリンクであるtopicsも返されます。limitは1ページあたりの件数で、1〜30(既定値は10)です。pageでページを切り替え、最終ページより先は空になります。別名や綴り間違いにも対応し、「zhu yuanzhang」で洪武帝が見つかり、「siddartha」ではdid_you_meanが返されます。その他のオプションは、下の「検索」をご覧ください。
/api/v1/articles/{slug}Markdown形式の記事、トピックのパス、地理ツリー上の位置(geo)、最終更新日、表示すべきクレジット表記を返します。どの形式の名前でも指定でき(Mount_Fuji、タイトル、完全なアドレス)、オプションにより、節、アウトライン、文章の一部、その他の形式で取得できます。下の「記事を読む」をご覧ください。
/api/v1/articles?id={id}同じ内容をIDで取得します。コーパスの移行後も、以前の記事IDで引き続き取得できます。トピックIDは、ツリーの改訂時に変わることがあります。アドレスが移動しても、以前のアドレスは引き続き応答し、moved_fromが含まれます。ids=では一度に最大10件を指定できます。
/api/v1/leads?ids={id},{id}IDで指定した最大50件の記事を、それぞれ検索結果の形式(ID、タイトル、最上位トピック、プレビューテキスト、リンク)で返します。カードを並べたページに利用できます。移行・統合されたIDについては、リクエストされたIDをキーとして、存続先の記事を返します。結果のidが正規IDです。不明なIDや利用できないIDは省かれます。
/api/v1/random無作為に選んだ記事を1件返します。new=1は最新の記事から、topic=またはgeo=は指定ノードの配下から選びます。
/api/v1/related/{slug}1回の呼び出しで、記事に近い記事を返します。同じトピック内で最も近い記事を最大10件、近接する最大8トピックからそれぞれ3件、その記事が属する各地理ノード内で最も近い記事をそれぞれ最大10件取得します。?id={id}もあります。by=linksを使うと、代わりに、その記事と一緒に引用されている記事を返します。
/api/v1/topicsトピックツリーの最上位を返します。
/api/v1/topics/{id}トピックのパス、記事数付きのサブトピック、その配下のすべての記事を1ページ30件ずつ返します。format=mermaidは、そのサブツリーを描画します。
/api/v1/geo地理ツリーを返します。各地域と、それぞれの時代区分が含まれます。
/api/v1/geo/{id}地理ノードを、トピックと同じ構造で返します。パス、より下位のノード、1ページ30件の記事が含まれます。地域については、その時代区分のみを列挙します。
POST /api/v1/ids/translatev1.5の移行が有効な場合、{"ids":["old-id", "another-id"]}(重複のないIDを最大500件)を送信します。レスポンスは、移動したIDを正規の存続先IDに対応付けます。変更のないIDや不明なIDは省かれます。完了したバッチのチェックポイントを保存し、Retry-Afterに従ってください。

プレビューテキストには、コーパスのスニペットがあればそれを使い、なければ記事の冒頭を使います。スニペットのあるレコードや結果には、snippetとしてもその内容が含まれます。markdownは引き続き記事の全文です。nodeがある場合は、その記事の現在の概念ツリー上のノードを示します。

各記事は、その記事のアドレスでもMarkdownとして取得できます。.mdを追加してください:www.edgepedia.org/koala.md。

MCPサーバー

https://www.edgepedia.org/mcp。Claudeにはカスタムコネクターとして、ChatGPTには開発者モードを有効にして追加できます。VS CodeやCursorにはワンクリックで、その他のMCPクライアントにはアドレスを指定して追加できます。APIキーもログインも不要です。読み取り専用のツールは5つあります。search(対象の名前を入力すると一致する記事を返し、その語がトピックを表す場合はトピックも返します)、fetch(記事1件をMarkdownで、クレジット表記、トピックのパス、地理情報とともに返します。citations: falseを使うと本文が約4分の1短くなります。topic:のIDでは、そのトピックの親、より下位のトピック、記事を、pageあたり120件ずつ列挙します。topic:rootとtopic:geoは、それぞれトピックツリーと地理ツリーの最上位です)、related(同じトピック、近接トピック、地理上で近い記事を返します。by: "links"では、一緒に引用されている記事を返します)、connect(from、to:/api/v1/pathと同じく、2つの記事をつなぐリンクの連鎖を返します)、resolve(name、任意でcontextとtype:/api/v1/resolveと同じく、ある名前が指す可能性が最も高い記事を返します)。searchで一致するタイトルがない場合は、本文に一致する記事が、タイトルが一致する記事の後に、match: fulltextを付けて返されます。これらもlimitの件数内に収まり、pagesに数えられます。ツールのエラーは、モデルが読むテキストです(どの記事にも属さないIDの場合は、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を受け取ります。すべての結果には、記事の永続IDであるcanonical_idが含まれます。fetchにはこのIDを指定できます。保存しておいたIDやアドレスが移動していた場合、fetchは、指定された値をmoved_fromに設定したうえで記事を返します。結果の_meta.corpus_versionには、コーパスのリリースが示されます。プロトコル2025-06-18以降のクライアントには、記事ごとにresource_linkも1件返されます。

リソースはedgepedia://article/{slug}(Markdown形式の記事で、fetchと同じテキスト)とedgepedia://topic/{id}(トピックの下位トピックと記事)で、どちらも補完に対応しています。記事を指定する引数では、記事タイトルの候補も補完で提示されます。エージェントスキルも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。その他すべてのクライアント用の設定コマンド、エージェントスキル、使用例:github.com/EdgePlat/edgepedia-mcp。

MCPを使わない場合や、クライアントが旧式のSSEトランスポートにしか対応していない場合は、/api/v1/searchと/api/v1/articles/{slug}を呼び出す2つの関数をモデルに与えるか、/tools.jsonから定義済みのものを取得してください。旧トランスポートのアドレス(/sse、/mcp/sse)は404を返し、本文でhttps://www.edgepedia.org/mcpを案内します。

制限

API、MCPサーバーともに、IPアドレスごとに毎分600リクエスト、1日10万リクエストまでです。すべてのレスポンスのRateLimit-Policyに、両方の時間枠の制限が示されます。上限を超えると、APIはRetry-AfterとRateLimitを伴う429を返します。MCPのツール呼び出しでは、retry_afterに秒数を示したツールエラーを返します。回数はサーバーインスタンスごとに集計されるため、これは正確な使用量の指標ではなく、超えないようにすべき上限です。キャッシュを利用してください。IDの変換では、リクエストしたIDを1件ずつ数えます。旧IDを調べる/leadsのバッチも、旧IDごとに数えます。その他のバッチでは、IDまたは名前1件を1リクエストと数え、annotateでは1,000文字ごとに1リクエストと数えます。

ライセンス

Edgepediaコミュニティライセンス1.0:クレジットを表示すれば、商用利用も含めて無料で利用できます。AIの学習には誰でも利用でき、モデルの出力にクレジットは不要です。それ以外の用途では、売上高が1億米ドルを超える組織、または月間ユーザー数が1億人を超える組織は、別途ライセンス契約が必要です。

クレジット:記事のテキストを表示するすべての場所に、その記事の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)を含み、記事のアドレスに該当するものがない場合は、最も近いタイトル3件を含むdid_you_meanも返します。MCPのfetchツールで記事が見つからない場合のエラーにも、同じdid_you_meanが含まれます。

変更

バージョン1では構造を維持します。フィールドを追加することはありますが、名前の変更や削除はしません。Edgepedia自体の変更は/edgepedia/updatesに掲載しています。1.8.0のように、リリースでトピックツリーが再編成された場合、移動したトピックIDは新しいIDを伴う301を返し、/api/v1/changes?since=<release>には、そのリリース以降に追加、変更、移動、削除されたすべての記事が列挙されます。

/api/v1は、corpus_version、corpus_updated、release_notesを返します。これらは公開されている「一般」コーパスのリリースとそのリリース日を示すもので、各記事の最終編集日ではありません。同じメタデータはMCPサーバーのインストラクションにも記載されています。コーパスのリリースによって、APIやMCPのソフトウェアバージョンが変わることはありません。そこにあるid_policyは、IDについて何が保証されるかを示します。1.5で行われたように、リリースによってIDが振り直されたり統合されたりすることはありますが、旧IDも308とPOST /api/v1/ids/translateを通じて引き続き応答します。

不具合がありましたか? 報告する。

リファレンス

派生データ(重要度、読解レベル、リンク、日付、別名、全文検索インデックス)を読み取るルートやフィールドは、そのデータがストアとともに公開されるまで、Retry-Afterを伴う503を返すか、そのフィールドを省略します。

記事を読む

/api/v1/articles/{slug}とMCPのfetchには、次のオプションを指定できます。指定しなければ記事全体を返します。

オプション返される内容
section={heading}見出し、またはその中の単語で指定した1つの節を、下位の節も含めて返します(section=etymologyは「名前と語源」を検索し、section=leadは冒頭部分を指します)。不明な見出しの場合は、記事のsectionsを伴う404を返します。
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は、MCPのcitations: falseと同じく、markdown、chunks、passages内の文中の出典リンクを[n]形式のマーカーに置き換えます。該当する記事がないアドレスは、記事のID(/api/v1/articles/ep7rbwcy0a)、または大文字・小文字とアクセント記号を区別せず記事タイトルとして解釈されます(/api/v1/articles/paris)。小文字とハイフンからなるアドレスで、その条件でも一致しない場合は、?suggest=1を追加しない限り404になります。一方、大文字、空白、アンダースコアを含むアドレス(/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、シカゴ、ハーバードの各スタイルでは、Markdownと同じく、イタリック体のタイトルをアスタリスクで囲みます。参照カードには、文献管理ソフト向けに、同じ文献情報がCOinSとJSON-LDとして非表示で埋め込まれています。

検索

match条件confidence
exactタイトルが検索語と一致します。最初の該当結果は1.0、それ以降は0.9
alias別名、またはタイトルの頭文字(「mlk」など)が一致します。0.8。最初の結果に検索語の単語が1つも含まれない場合は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未満の場合、レスポンスは空になります。各結果には、要約の中で検索語の単語を最も多く含む1文がhighlightとして含まれます。何も見つからなかった検索は、ラテン文字に変換してもう一度だけ実行され(キリル文字、ギリシャ文字、仮名、ハングルを字訳し、ピンインの声調番号を除き、ローマ字の重複する母音を1字にします)、その検索語がsearched_asとしてレスポンスに示されます。漢字は字訳しません。

オプション動作
first=true最もよく一致する1件だけを返します。一致するものがなければ何も返しません。
topic={id}, geo={id}指定したトピックまたは地理ノードの配下の記事に限定します。geoは、一致する最大1,000件すべてを絞り込みの対象とし、scopeは、レスポンスがどの範囲までを対象としているかを示します。
sort=central一致する最大1,000件の中で、リンクされている数が多い対象から順に返します。
max_grade={grade}読解レベルが指定の学年以下の記事に限定します。
facets=1一致する最大1,000件すべてについて、最上位トピック別、地理上の地域別に件数を返します(facets.counted)。

すべてのレスポンス

fields=a,bは、各結果のうち指定したキーだけを残します(結果を含まないレスポンスの場合は、そのレスポンスのキーが対象です)。外枠の情報(total、page、next、license)は残ります。キャッシュ可能な200レスポンスにはETagが含まれます。これをIf-None-Matchとして送り返すと、レスポンスの内容に変更がなければ、本文のない304が返されます。Last-Modifiedはコーパスのリリース日で、参考情報です。Edgepedia-Corpus-Versionはコーパスのリリースを示し、Content-Digestは本文のSHA-256です(RFC 9530)。記事の.mdにも、この両方が含まれます。

その他のルート

ルート返される内容
/api/v1/articles?after={id}&limit={1..1000}「一般」コレクションの全記事を、一定の順序でたどって取得します。{id, slug, title, api_url}とnext(最後はnull)を返します。after=を空にすると先頭から始まり、どのIDの後からでも再開できます。削除されたIDでもかまいません。
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoトピックツリーと地理ツリーの全体:nodes: [[id, label, parent index, own articles]]。ドットで始まるIDは、親のIDに続けて読みます。
/api/v1/releases新しい順に並んだコーパスのリリースと、currentを返します。
/api/v1/healthapplication/health+json:pass、warn、またはfail(503)を返します。
/api/v1/manifest1記事1行の、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 }、およびYYYY、YYYY-MM、YYYY-MM-DDのいずれかの形式のdateです(紀元前は負の値:-0044-03-15)。紀元前の日付は、天文学的紀年法ではなく歴史上の慣例に従います。-0044は紀元前44年です(標準的なISO 8601パーサーでは紀元前45年と解釈されます)。根拠となるのはその文です。日付を事実として扱う前に、文を読んでください。
/api/v1/aliases/{id}記事の別名を返します。記事に記載された頭字語(「NASA」など)も含みます。綴り間違いや大文字・小文字だけが異なるものは除外し、同じ名前に2種類の綴りがある場合は、ピリオドのない方を残します(「W.H.O.」ではなく「WHO」)。

名前の解決、注釈付け、照合

自由記述のテキストを入力すると、記事IDを返します。モデルも埋め込みも使いません。annotate、classify、geoparseに送信されたテキストは、ログへの記録も保存も一切行いません。

ルート返される内容
/api/v1/resolve?name=Mercury&context=planet名前が指す可能性が最も高い記事を返します。result、confidence、ambiguous、match(exact、alias、anchor、partial、noneのいずれか)、alternativesが含まれます。type=は、1つのトピックIDの配下に候補を限定します(名前に一致する最初の30件に該当するものがない場合、単一の名前のリクエストでは、さらに次の60件を調べます)。limit=は1〜10です。POSTは最大50件を受け取ります:{ "names": ["Paris", "Koala"] }または{ "queries": [{ "name": "Mercury", "context": "planet" }] }。名前だけでは1つの記事に絞れない場合、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)、記事、信頼度を返します。位置はJavaScriptの文字列インデックスと同じUTF-16コード単位です。Pythonで扱う際は、絵文字など基本多言語面の外にある文字を2単位として数えます。?format=htmlでは、HTMLエスケープを施し、各語句にリンクを付けたテキストも返します。
POST /api/v1/classify{ "text": "…" }:テキストが扱うトピックを、言及された記事のトピックのパスに基づいてスコア付けし、最上位トピックごとの割合とともに返します。
POST /api/v1/geoparse{ "text": "…" }:テキストに登場する場所と時代を、地理ツリー上の位置として返します(nodes、regions、places、periods)。ツリーの地理以外の分岐(geo.nongeo)は、場所としては扱いません。
/api/v1/mentions?term=CRISPR対象に言及しているものの、その記事へのリンクがない記事を返します。complete: falseは、リンク元記事の一覧が途中で打ち切られたことを示します。
/api/v1/reconcileReconciliation Service API 0.2のエンドポイントです。マニフェスト、バッチqueries(GETまたはPOST)、エンティティ・型・プロパティの候補提示、プレビュー、データ拡張(title、url、excerpt、topic、topic_path、importance_rank)に対応しています。callback=を指定するとJSONPを使えます。OpenRefineでは、Reconcile › Start reconciling › Add standard serviceの順に選び、https://www.edgepedia.org/api/v1/reconcileを貼り付けてください。

リンクグラフ、日付、一覧

図(format=mermaid)はMermaid形式のテキストで、表示先のシステムで描画します。

ルート返される内容
/api/v1/links/{slug}記事からほかの記事へのリンクを、本文に出てくる順に、それぞれのアンカーテキストと、そのリンクを含む文とともに返します。
/api/v1/backlinks/{slug}?page=その記事へリンクしている記事を、重要度の高い順に1ページ30件ずつ、アンカーテキストとともに返します。
/api/v1/path?from=&to=2つの記事をつなぐ最短のリンクの連鎖を、各移動の根拠となる文とともに返します(最大6ホップで、可能な限りハブを避けます)。MCPサーバーではconnectと呼びます。
/api/v1/compare?a=&b=2つの記事を並べて返します。冒頭部分、トピックのパス、共通する最下位のトピック、記事間のリンクの連鎖、共通のリンクとそれぞれに固有のリンク、各記事の「基本情報」表が含まれます。
/api/v1/graph/{slug}?depth=1|2&limit=重要度の高い近傍記事を最大limit件(既定値は50、上限は200)と、それらの間のすべてのリンクを返します。complete: falseは、このルートでも、backlinksとrank/topでも、ルートの処理時間の目安である約1秒に達したために、レスポンスが途中で打ち切られたことを示します。そのようなレスポンスのキャッシュ期間は1分間のみです。
POST /api/v1/context{ "ids": [...] }として最大50件のIDまたはアドレスを受け取り(/rank?ids=と/leads?ids=でも同様に指定できます)、それらの間のリンク、それらの大半とリンクでつながる記事、共通する最下位のトピックと場所、各記事の冒頭部分を返します。
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=PageRankによる重要度を返します。prはコーパス全体で合計1となり、順位1が最も中心的です。フィールド名に注意してください。/searchと記事のimportanceは、この順位を0〜1のパーセンタイルで表したものです。/resolveのimportanceはprの生の値で、/leadsでは{ pr, rank }です。
/api/v1/timeline?topic=|geo=&from=&to=トピックまたは場所に属する記事から、日付を含む文を古い順に1ページ50件ずつ返します。紀元前の年は負の値です。各ノードでは、日付の範囲全体に分散するように最大200件の出来事を保持し、fromとtoは、その標本を絞り込みます。標本が上限に達している場合、そこから得られたレスポンスにはsampled: trueとそのcapが示され、totalは標本内の件数を数えます。
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}1年のうちのある月日(既定値はUTCでの今日)、またはある年(-9999〜2100)の出来事を返します。1つの月日につき最大500件、1つの年につき最大2,000件を保持し、上限に達している場合はsampled: trueを示します。
/api/v1/featured?date=, /api/v1/featured.xmlその日の注目記事(トップページの「今日の豆知識」)と、過去10日間のAtomフィードを返します。
/api/v1/list?topic=|geo=&period=&type=personトピック、または場所と時代(TBC、T500、T1000、T1800、T1946、T2001、T2021、NODATE)に属する記事を、1ページ30件ずつ返します。type=personは人物の記事に限定します。地理の一覧の各行にはgeoが含まれますが、idは含まれません(必要な場合は記事を取得してください)。
/api/v1/keyterms?topic=|geo=&limit=音声認識器にあらかじめ与えるための、サブツリー内のタイトルと別名を返します。
/api/v1/stats?topic=|geo=&by=periodコーパス全体、またはあるノードとその下位ノードについて、記事、リンク、別名の件数だけを返します。ここではarticlesは重複のない記事数です。/geoと/trees/geoでは配置数を数えるため、同じ地域の2つの時代に属する記事は、そちらでは2件と数えます。

ディスカバリーとその他のプロトコル

生成ファイル

/openapi.jsonから生成されるため、内容が食い違うことはありません。

ファイル内容
/openapi-3.0.json3.1を読み込めないツール向けに、同じ記述をOpenAPI 3.0.3形式にしたものです。
/arazzo.json検索し、最もよく一致する記事を取得し、続いてその関連記事を取得する、Arazzo 1.0のワークフローです。
/tools.jsonJSONを返すすべてのルートを、モデルが呼び出せる関数として、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向けに、各ルートのリクエスト例を1つずつ収録しています。

これらのコレクションと同じように、プログラム名を明記したUser-Agentを送信してください(edgepedia-collection/1)。