edgepedia

Edgepedia

Edgepedia-API

Mehr als 500.000 Enzyklopädieartikel, und es werden ständig mehr. Als JSON. Kostenlos. Kein Schlüssel, keine Registrierung. Kommerzielle Nutzung mit Quellenangabe. KI-Training steht allen offen.

Ausprobieren

Lesende Routen verwenden GET; Migration, Stapelanfragen und das Übermitteln eigener Texte verwenden POST. Jede Route liefert JSON an beliebige Programme oder Webseiten zurück (CORS erlaubt jeden Ursprung). Maschinenlesbare Beschreibung: /openapi.json, mit einer Beispielantwort für jede Route. Dieselbe Beschreibung in OpenAPI 3.0, Funktionsdefinitionen für Modelle, TypeScript-Typen und Anfragesammlungen sind weiter unten unter „Generierte Dateien“ aufgeführt.

Referenzkarten

Darstellung

Ausgewählt: Cantor's diagonal argument

Vorschau

Titel, vollständige Zusammenfassung und Edgepedia-Quellenangabe eines Artikels als Karte für Ihre Website.

/embed/{id}?theme=auto liefert eine Karte anhand der kanonischen Artikel-ID. Als Darstellung sind auto, light oder dark möglich. Das optionale Skript /assets/edgepedia-embed.js passt den Rahmen an den Inhalt an; ohne das Skript bleibt der Rahmen lesbar und scrollbar.

/embed/{slug} funktioniert ebenfalls: Es leitet zur Karte unter der Artikel-ID weiter und behält dabei das Farbschema bei. Edgepedia ist auch ein oEmbed-Anbieter: GET /oembed?url={article or card URL}&format=json gibt denselben Einbettungscode wie der obige Konfigurator als html zurück, zusammen mit Titel, Breite und Höhe; maxwidth und maxheight werden berücksichtigt. Jede Artikelseite im General-Korpus verlinkt ihre oEmbed-Adresse in ihrem <head>. So machen WordPress, Discourse und andere oEmbed-Clients aus einem eingefügten Edgepedia-Link eine Karte.

Routen

RouteRückgabe
/api/v1/search?q=wordsSucht nach passenden Titeln und anderen Namen, die besten Treffer zuerst. Suchen Sie nach dem Namen eines Gegenstands, nicht nach einer Frage. Jedes Ergebnis enthält: ID, Titel, Thema der obersten Ebene, Vorschautext, Links und die Art des Treffers (match, confidence). Begriffe, die ein Thema bezeichnen, etwa „science fiction writers“, liefern außerdem topics, einen Link zu den zugehörigen Artikeln. limit legt die Seitengröße fest, von 1 bis 30 (Standard: 10); page blättert durch die Seiten. Eine Seite hinter dem Ende ist leer. Andere Namen und Schreibfehler funktionieren ebenfalls: „zhu yuanzhang“ findet den Hongwu-Kaiser, und „siddartha“ liefert did_you_mean. Weitere Optionen: siehe „Suche“ weiter unten.
/api/v1/articles/{slug}Den Artikel als Markdown, seinen Themenpfad, seine Positionen im Geografiebaum (geo), das Datum seiner letzten Aktualisierung und die anzuzeigende Quellenangabe. Jeder Name funktioniert (Mount_Fuji, ein Titel, eine vollständige Adresse). Mit Optionen lassen sich ein Abschnitt, eine Gliederung, Textpassagen oder andere Formen abrufen: siehe „Einen Artikel lesen“ weiter unten.
/api/v1/articles?id={id}Dasselbe, anhand der ID. Alte Artikel-IDs werden auch nach einer Korpusmigration weiter aufgelöst; Themen-IDs können sich ändern, wenn der Baum überarbeitet wird. Eine Adresse kann sich ändern; die alte liefert weiterhin eine Antwort, mit moved_from. ids= nimmt bis zu 10 auf einmal entgegen.
/api/v1/leads?ids={id},{id}Bis zu 50 Artikel anhand ihrer ID, jeweils als Suchergebnis (ID, Titel, Thema der obersten Ebene, Vorschautext, Links), für eine Seite mit Karten. Migrierte und zusammengeführte IDs liefern den weitergeführten Artikel, unter der angefragten ID als Schlüssel; id im Ergebnis ist kanonisch. Unbekannte oder nicht verfügbare IDs werden ausgelassen.
/api/v1/randomEinen zufälligen Artikel. new=1 wählt aus den neuesten Artikeln; topic= oder geo= wählt unterhalb eines Knotens.
/api/v1/related/{slug}Die Nachbarn eines Artikels mit einem einzigen Aufruf: bis zu 10 der nächstgelegenen Artikel im eigenen Thema, je 3 aus bis zu 8 benachbarten Themen und bis zu 10 der nächstgelegenen Artikel in jedem Geografieknoten, dem er zugeordnet ist. Auch ?id={id}. by=links liefert stattdessen die Artikel, die gemeinsam mit ihm zitiert werden.
/api/v1/topicsDie oberste Ebene des Themenbaums.
/api/v1/topics/{id}Den Pfad eines Themas, seine Unterthemen mit Artikelzahlen sowie sämtliche Artikel darunter, 30 pro Seite. format=mermaid stellt seinen Teilbaum dar.
/api/v1/geoDen Geografiebaum: seine Regionen, jeweils mit ihren Zeiträumen.
/api/v1/geo/{id}Einen Geografieknoten, aufgebaut wie ein Thema: seinen Pfad, untergeordnete Knoten und Artikel, 30 pro Seite. Eine Region listet nur ihre Zeiträume auf.
POST /api/v1/ids/translateBei aktivierter Migration für v1.5: Senden Sie {"ids":["old-id", "another-id"]} (bis zu 500 unterschiedliche IDs). Die Antwort ordnet verschobenen IDs ihre kanonischen, weitergeführten IDs zu; unveränderte oder unbekannte IDs werden ausgelassen. Speichern Sie den Fortschritt abgeschlossener Stapel und beachten Sie Retry-After.

Als Vorschautext wird, sofern vorhanden, der Korpusauszug verwendet, andernfalls der Artikelanfang. Datensätze und Ergebnisse mit einem Auszug enthalten diesen zusätzlich als snippet; markdown bleibt der vollständige Artikeltext. node bezeichnet, sofern vorhanden, den aktuellen Knoten des Artikels im Begriffsbaum.

Jeder Artikel ist unter seiner eigenen Adresse auch als Markdown verfügbar. Fügen Sie .md hinzu: www.edgepedia.org/koala.md.

MCP-Server

https://www.edgepedia.org/mcp. Fügen Sie ihn Claude als benutzerdefinierten Konnektor hinzu, ChatGPT bei aktiviertem Entwicklermodus, VS Code oder Cursor mit einem Klick oder jedem anderen MCP-Client über seine Adresse. Kein Schlüssel, keine Anmeldung. Fünf rein lesende Tools: search (nimmt den Namen eines Gegenstands entgegen und liefert passende Artikel sowie ein Thema, wenn die Wörter eines bezeichnen), fetch (ein Artikel als Markdown, mit Quellenangabe, Themenpfad und geografischer Zuordnung; citations: false für einen um etwa ein Viertel kürzeren Text; eine topic:-ID listet das übergeordnete Thema, die untergeordneten Themen und die Artikel dieses Themas auf, 120 pro page; topic:root und topic:geo sind die obersten Ebenen des Themen- und des Geografiebaums), related (die Nachbarn eines Artikels in seinem Thema, in benachbarten Themen und in der geografischen Zuordnung; by: "links" für die gemeinsam mit ihm zitierten Artikel), connect (from, to: die Kette von Links zwischen zwei Artikeln, wie von /api/v1/path geliefert) und resolve (name, optional mit context und type: der Artikel, den ein Name am wahrscheinlichsten bezeichnet, wie von /api/v1/resolve geliefert). Wenn bei search kein Titel passt, folgen Artikel mit passenden Textstellen auf die Titeltreffer, gekennzeichnet mit match: fulltext, innerhalb von limit und mitgezählt in pages. Ein Tool-Fehler ist Text, den das Modell liest (mit did_you_mean-IDs bei einer ID, zu der es keinen Artikel gibt); sein Code steht in _meta["ai.edgechat/error"], niemals in structuredContent. fetch mit links: "in" nimmt links_page entgegen, um die nächsten 30 Artikel abzurufen, die dorthin verlinken.

search nimmt limit (1 bis 30, Standard: 10), page, first, topic und sort entgegen und liefert page und pages zurück; fetch nimmt die unten aufgeführten Artikeloptionen entgegen sowie ids für mehrere Artikel auf einmal. Jedes Ergebnis enthält canonical_id, die dauerhafte ID des Artikels: fetch nimmt sie entgegen. Hat sich eine von Ihnen gespeicherte ID oder Adresse geändert, liefert fetch den Artikel zurück und setzt moved_from auf den von Ihnen angefragten Wert. Ergebnisse nennen die Korpusversion in _meta.corpus_version. Clients mit Protokollversion 2025-06-18 oder neuer erhalten außerdem ein resource_link pro Artikel.

Ressourcen: edgepedia://article/{slug} (ein Artikel als Markdown, derselbe Text wie bei fetch) und edgepedia://topic/{id} (die untergeordneten Themen und Artikel eines Themas), beide mit Autovervollständigung; diese schlägt außerdem Artikeltitel für jedes Argument vor, das einen Artikel benennt. Der Agent Skill wird ebenfalls über MCP bereitgestellt (skills/list, skills/get), als skill://edgepedia/SKILL.md. Ein GET von /mcp liefert die Serverkarte als JSON zurück. Clients, die nur text/event-stream akzeptieren, erhalten jede Antwort als ein einzelnes SSE-Ereignis vom Typ message. Der sha256-Hash der Tool-Liste steht in _meta jeder Antwort (ai.edgechat/tools-sha256), sodass Änderungen an einer Tool-Beschreibung sichtbar sind.

Windows (Vorschauversion, Build 26220.7262 oder neuer): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Einrichtungseinträge für alle anderen Clients, ein Agent Skill und Beispiele: github.com/EdgePlat/edgepedia-mcp.

Kein MCP oder ein Client, der nur den älteren SSE-Transport unterstützt? Geben Sie Ihrem Modell zwei Funktionen, die /api/v1/search und /api/v1/articles/{slug} aufrufen, oder übernehmen Sie die fertigen Funktionen aus /tools.json. Die Adressen des älteren Transports (/sse, /mcp/sse) antworten mit 404 und einem Antwortinhalt, der auf https://www.edgepedia.org/mcp verweist.

Limits

600 Anfragen pro Minute und 100.000 pro Tag je IP-Adresse, sowohl für die API als auch für den MCP-Server. Jede Antwort nennt beide Zeitfenster in RateLimit-Policy. Werden sie überschritten, antwortet die API mit 429 sowie Retry-After und RateLimit; ein MCP-Tool-Aufruf liefert einen Tool-Fehler, dessen retry_after die Wartezeit in Sekunden angibt. Die Zähler werden pro Serverinstanz geführt. Sie sind daher als Obergrenze zu verstehen, die nicht erreicht werden sollte, nicht als exakter Verbrauchszähler. Bitte nutzen Sie einen Cache. Bei POST /api/v1/ids/translate zählt jede angefragte ID einzeln; /leads-Stapel, die alte IDs prüfen, werden ebenfalls pro alter ID gezählt. Andere Stapelanfragen zählen jede ID oder jeden Namen als eine Anfrage; bei annotate zählt eine Anfrage je 1.000 Zeichen.

Lizenz

Edgepedia Community License 1.0: kostenlos mit Quellenangabe, auch für kommerzielle Nutzung. KI-Training steht allen offen, und die Ausgabe eines Modells erfordert keine Quellenangabe. Für andere Nutzungsarten benötigen Organisationen mit mehr als 100 Millionen US-Dollar Umsatz oder 100 Millionen monatlichen Nutzern eine gesonderte Lizenz.

Quellenangabe: Zeigen Sie die Zeile credit jedes Artikels samt Link überall dort an, wo Sie seinen Text anzeigen. Artikelantworten enthalten sie außerdem fertig zum Einfügen als credit_md und credit_html sowie license.spdx (LicenseRef-Edgepedia-Community-1.0). Antworten der API auf Artikel- und /leads-Anfragen enthalten Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" und X-License: LicenseRef-Edgepedia-Community-1.0.

Die EdgeChat-App, ihre Edge Apps und unsere Software sind kostenlos, aber proprietär: Quellcode wird nicht bereitgestellt; sie dürfen weder kopiert noch verändert oder weiterverbreitet werden (EdgeChat-Lizenzvereinbarung).

Fehler

JSON: { "error": { "code": "not_found", "message": "…" } }. 400: q fehlt; 404: nicht gefunden; 410: entfernt; 413: Text zu lang; 429: zu viele Anfragen; 503: erneut versuchen. Eine 404-Antwort nennt den nächsten Aufruf: hint, next (eine URL) und, bei einer Artikeladresse, die nichts liefert, did_you_mean mit den drei ähnlichsten Titeln. Der Nicht-gefunden-Fehler des MCP-Tools fetch enthält dasselbe did_you_mean.

Änderungen

Version 1 behält ihre Struktur: Felder können hinzukommen, werden aber nie umbenannt oder entfernt. Änderungen an Edgepedia selbst stehen unter /edgepedia/updates. Wenn eine Version den Themenbaum neu ordnet, wie es bei 1.8.0 der Fall war, antwortet eine verschobene Themen-ID mit 301 und ihrer neuen ID. /api/v1/changes?since=<release> listet alle Artikel auf, die seit dieser Version hinzugefügt, geändert, verschoben oder entfernt wurden.

/api/v1 meldet corpus_version, corpus_updated und release_notes. Diese Angaben bezeichnen die veröffentlichte Version des General-Korpus und deren Veröffentlichungsdatum, nicht das Datum der letzten Bearbeitung jedes einzelnen Artikels. Dieselben Metadaten stehen in den MCP-Serveranweisungen. Korpusversionen ändern die Softwareversion der API oder von MCP nicht. Das dortige id_policy beschreibt, was eine ID zusichert: IDs können durch eine neue Version neu nummeriert oder zusammengeführt werden, wie bei 1.5. Alte IDs liefern weiterhin Antworten, über eine 308-Weiterleitung und POST /api/v1/ids/translate.

Etwas funktioniert nicht? Problem melden.

Referenz

Routen und Felder, die aus abgeleiteten Daten lesen (Wichtigkeit, Lesestufen, Links, Datumsangaben, andere Namen und der Volltextindex), antworten mit 503 und Retry-After oder lassen das Feld weg, bis diese Daten zusammen mit dem Datenbestand veröffentlicht sind.

Einen Artikel lesen

/api/v1/articles/{slug} und MCP fetch akzeptieren die folgenden Optionen; ohne sie enthält die Antwort den gesamten Artikel.

OptionRückgabe
section={heading}Einen Abschnitt anhand seiner Überschrift oder eines darin enthaltenen Wortes (section=etymology findet „Name and etymology“; section=lead bezeichnet die Einleitung), einschließlich seiner Unterabschnitte. Bei einer unbekannten Überschrift wird 404 mit sections des Artikels zurückgegeben.
outline=1outline: sämtliche Überschriften mit ihrem jeweiligen Umfang in Tokens.
max_tokens={n}Den an einer Abschnitts- oder Absatzgrenze auf etwa n Tokens gekürzten Text, mit tokens_estimate, truncated und next_cursor; übergeben Sie dies als cursor mit demselben max_tokens, um den Rest abzurufen.
length=snippet, length=leadDen Auszug oder den Titel samt erstem Absatz anstelle des gesamten Textes.
format=text, html, jsonld, turtle, tablesDie Antwort als reinen Text, als gerenderten Inhalt oder als JSON-LD beziehungsweise Turtle der öffentlichen Felder; tables liefert jede Tabelle als columns und rows, als csv und mit ihren Belegen nach cites und sources verschoben.
chunks=1chunks: den Artikel in Absätzen, jeweils mit einer stabilen, aus dem Überschriftenpfad abgeleiteten ID (geology-2) und einem cite_url.
q={words}&k={1–10}passages: die k Absätze (Standard: 3), die am besten zu den Wörtern passen, jeweils mit einem cite_url.
quote={sentence or chunk id}cite_url: die Artikeladresse mit einem Textfragment, das die Seite an dieser Passage öffnet; quote_found gibt an, ob der Artikel sie enthält.
cite={format}cite: eine Literaturangabe zum Artikel, wie von /api/v1/cite geliefert.

Jede Artikelantwort enthält außerdem speakable (den Auszug in einer Form, die ein Sprachassistent vorlesen kann). importance und rank (PageRank über die Links zwischen Artikeln; 1 bezeichnet den zentralsten Artikel; eine Zählung der Links, keine Bewertung des Gegenstands), words, reading_grade (Flesch-Kincaid) und reading_minutes werden nur mitgeliefert, wenn fields= sie nennt (?fields=title,importance,rank); MCP fetch enthält sie immer. next=1 fügt bis zu 5 Artikel zum Weiterlesen hinzu. citations=false ersetzt die Quellenlinks im Fließtext von markdown, chunks und passages durch [n]-Markierungen, ebenso wie citations: false bei MCP. Eine Adresse, die keinem Artikel zugeordnet ist, wird als Artikel-ID (/api/v1/articles/ep7rbwcy0a) oder als Titel gelesen, ohne Berücksichtigung von Groß- und Kleinschreibung sowie Akzenten (/api/v1/articles/paris); eine kleingeschriebene Adresse mit Bindestrichen, die stärker davon abweicht, führt zu 404, sofern Sie nicht ?suggest=1 hinzufügen. Eine Adresse mit Großbuchstaben, Leerzeichen oder Unterstrichen (/api/v1/articles/Albert_Einstein) wird dagegen als Name gelesen, sodass bei einer geringfügigen Abweichung der beste Suchtreffer mit resolved_by: search zurückgegeben wird. Ist der angegebene Name nicht die Adresse des Artikels, nennt die Antwort die Art der Auslegung (resolved_from, resolved_by: Adresse, Titel oder Suche) und führt die 3 anderen Artikel unter nearest auf. /api/v1/articles?ids={slug or id},{name} liefert bis zu 10 als articles (jeweils mit dem Namen, für den sie gefunden wurden, als asked) und missing zurück; jede Option gilt für alle einzeln.

Einen Artikel zitieren

/api/v1/cite/{slug}?format= liefert eine Literaturangabe in csl (CSL-JSON, Standard), bibtex, ris, apa, mla, chicago oder harvard, mit der Quellenangabe als Text, Markdown und HTML; /api/v1/cite?ids={id},{slug} tut dasselbe für bis zu 50 Artikel. Als Autor ist Edgepedia (EdgeChat) angegeben; APA, MLA, Chicago und Harvard kennzeichnen den kursiven Titel wie Markdown mit Sternchen. Referenzkarten enthalten dieselbe Literaturangabe unsichtbar als COinS und JSON-LD für Literaturverwaltungsprogramme.

Suche

matchWannconfidence
exactDer Titel entspricht der Suchanfrage.1,0 für das erste solche Ergebnis, 0,9 für ein späteres
aliasEin anderer Name oder die Anfangsbuchstaben des Titels („mlk“) stimmen überein.0,8; 0,7 für ein erstes Ergebnis, das kein Wort der Suchanfrage enthält; 0,6 für eine transliterierte Suchanfrage
misspellingDie Suche hat die Suchanfrage korrigiert (did_you_mean).0,5 × der Anteil der eingegebenen Suchanfrage, der bei der Korrektur erhalten blieb
partialEinige Wörter der Suchanfrage stehen im Titel oder nur im Text.0,2 + 0,5 × der Anteil der Suchwörter im Titel; 0,2 bei Treffern nur im Text
fulltextKein Titel oder anderer Name stimmte überein, daher wurde der Artikeltext durchsucht (BM25): Eine Beschreibung findet den Artikel, dessen Namen Sie nicht kennen.mindestens 0,2
noneKeine Übereinstimmung. Die Antwort ist leer.0

Der Konfidenzwert folgt einer festen Regel und ist keine kalibrierte Wahrscheinlichkeit; eine Antwort, deren bestes Ergebnis unter 0,2 liegt, wird leer zurückgegeben. Jedes Ergebnis enthält highlight, den Satz seiner Zusammenfassung mit den meisten Wörtern aus der Suchanfrage. Eine erfolglose Suche wird einmal in lateinischen Buchstaben wiederholt (Kyrillisch, Griechisch, Kana und Hangul werden transliteriert, Tonziffern im Pinyin entfernt, doppelte Vokale im Rōmaji gekürzt); die Antwort weist dies als searched_as aus. Chinesische Schriftzeichen werden nicht transliteriert.

OptionWirkung
first=trueNur der beste Treffer oder keiner.
topic={id}, geo={id}Nur Artikel unterhalb dieses Themas oder Geografieknotens; geo filtert sämtliche Treffer bis zu einer Zahl von 1.000, und scope gibt an, wie weit die Antwort reicht.
sort=centralDie am häufigsten verlinkten Gegenstände zuerst, unter sämtlichen Treffern bis zu einer Zahl von 1.000.
max_grade={grade}Nur Artikel auf oder unter dieser Lesestufe.
facets=1Trefferzahlen nach Thema der obersten Ebene und geografischer Region, über sämtliche Treffer bis zu einer Zahl von 1.000 (facets.counted).

Jede Antwort

fields=a,b behält nur die angegebenen Schlüssel jedes Ergebnisses bei (oder der Antwort, wenn sie keine Ergebnisse enthält); die umschließenden Felder (total, page, next, license) bleiben erhalten. Eine cachefähige 200-Antwort enthält einen ETag: Senden Sie ihn als If-None-Match zurück, und eine unveränderte Antwort wird als 304 ohne Antwortinhalt geliefert. Last-Modified ist das Veröffentlichungsdatum der Korpusversion und dient nur zur Information. Edgepedia-Corpus-Version nennt die Korpusversion, und Content-Digest ist der SHA-256-Hash des Antwortinhalts (RFC 9530); .md eines Artikels enthält ebenfalls beide Angaben.

Weitere Routen

RouteRückgabe
/api/v1/articles?after={id}&limit={1..1000}Alle Artikel des General-Korpus in einer festen Reihenfolge durchlaufen: {id, slug, title, api_url} und next (am Ende null). Ein leeres after= beginnt am Anfang; nach jeder beliebigen ID lässt sich der Durchlauf fortsetzen, auch nach einer entfernten.
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoDen gesamten Themen- und Geografiebaum: nodes: [[id, label, parent index, own articles]]; eine mit einem Punkt beginnende ID setzt die ID ihres übergeordneten Knotens fort.
/api/v1/releasesKorpusversionen, die neueste zuerst, und current.
/api/v1/healthapplication/health+json: pass, warn oder fail (503).
/api/v1/manifestEine Weiterleitung zu einer einzigen gzip-komprimierten JSONL-Datei, eine Zeile pro Artikel: { id, slug, title, updated, sha256, topic } (sha256 von .md des Artikels). Laden Sie sie einmal herunter, um Edgepedia zu spiegeln. Die Prüfsumme bezieht sich auf den veröffentlichten Text vor Korrekturen aufgrund von Leserhinweisen: Ein Artikel, der seit der Veröffentlichung aufgrund eines solchen Hinweises geändert wurde, stimmt erst mit der nächsten Version wieder mit ihr überein.
/api/v1/changes?since={release}Die Änderungsdateien von der angegebenen bis zur aktuellen Version, in der richtigen Reihenfolge (der Feed beginnt bei 1.5: since=1.5 ist die früheste Version); jede Zeile ist { op, id, … }, wobei op einen der Werte added, changed, moved (from_slug ist die alte Adresse) oder removed hat.
/api/v1/events/{slug}Die Sätze eines Artikels, die ein Datum nennen: { date, precision, text, para }, date als YYYY, YYYY-MM oder YYYY-MM-DD (vor unserer Zeitrechnung negativ: -0044-03-15). Datumsangaben vor Christus folgen der historischen Konvention, nicht der astronomischen Jahreszählung: -0044 ist 44 v. Chr. (ein standardkonformer ISO-8601-Parser würde dies als 45 v. Chr. lesen). Der Satz ist der Beleg: Lesen Sie ihn, bevor Sie das Datum als Tatsache behandeln.
/api/v1/aliases/{id}Andere Namen eines Artikels, einschließlich der in den Artikeln genannten Akronyme („NASA“); Schreibfehler und Varianten der Groß- und Kleinschreibung werden ausgelassen. Gibt es für einen Namen eine Schreibweise mit und eine ohne Punkte, bleibt die ohne Punkte erhalten („WHO“, nicht „W.H.O.“).

Auflösen, annotieren und abgleichen

Freitext hinein, Artikel-IDs heraus, ohne Modell und ohne Embeddings. Texte, die an annotate, classify und geoparse gesendet werden, werden weder protokolliert noch gespeichert.

RouteRückgabe
/api/v1/resolve?name=Mercury&context=planetDen Artikel, den ein Name am wahrscheinlichsten bezeichnet: result, confidence, ambiguous, match (exact, alias, anchor, partial oder none) und alternatives. type= beschränkt die Kandidaten auf eine Themen-ID (liegt keiner der ersten 30 Treffer des Namens darunter, werden bei einem einzeln angefragten Namen die nächsten 60 durchsucht); limit= von 1 bis 10. POST nimmt bis zu 50 entgegen: { "names": ["Paris", "Koala"] } oder { "queries": [{ "name": "Mercury", "context": "planet" }] }. Lässt sich allein anhand eines Namens kein eindeutiger Artikel bestimmen, lautet die Antwort ambiguous: true, mit dem wahrscheinlichsten Treffer als result; übergeben Sie context, um eine Auswahl zu treffen.
/api/v1/surface?form=mercuryAlle Artikel, auf die diese genaue Formulierung in den Links des Korpus verweist, mit Linkzahlen und dem jeweiligen Anteil (commonness).
/api/v1/suggest?prefix=koaZuerst den Artikel mit genau diesem Titel, dann einen mit genau diesem anderen Namen, dann Titel, die mit dem Präfix beginnen, und schließlich andere Namen, die damit beginnen (matched liefert diesen Namen), für Suchfelder und Sprachschnittstellen.
POST /api/v1/annotate{ "text": "…" } (höchstens 20.000 Zeichen): jede verlinkte Formulierung mit ihren Positionen (start, end, in UTF-16-Codeeinheiten, entsprechend den Zeichenkettenindizes in JavaScript: In Python zählt ein Zeichen außerhalb der mehrsprachigen Basisebene, etwa ein Emoji, als zwei), Artikel und Konfidenzwert. ?format=html liefert außerdem den Text mit maskierten HTML-Sonderzeichen und verlinkten Formulierungen zurück.
POST /api/v1/classify{ "text": "…" }: die Themen des Textes, bewertet anhand der Themenpfade der darin erwähnten Artikel, sowie die Anteile auf der obersten Ebene.
POST /api/v1/geoparse{ "text": "…" }: die darin genannten Orte und Zeiträume im Geografiebaum (nodes, regions, places, periods); der nicht geografische Zweig des Baums (geo.nongeo) ist nie ein Ort.
/api/v1/mentions?term=CRISPRArtikel, die einen Gegenstand erwähnen, ohne auf seinen Artikel zu verlinken; complete: false bedeutet, dass die Liste der verlinkenden Artikel gekürzt wurde.
/api/v1/reconcileEinen Endpunkt für die Reconciliation Service API 0.2: das Manifest, Stapelanfragen mit queries (GET oder POST), Vorschläge für Entitäten, Typen und Eigenschaften, eine Vorschau sowie Datenerweiterung (title, url, excerpt, topic, topic_path, importance_rank). JSONP mit callback=. In OpenRefine: Reconcile › Start reconciling › Add standard service, dann https://www.edgepedia.org/api/v1/reconcile einfügen.

Linkgraph, Datumsangaben und Listen

Diagramme (format=mermaid) sind Mermaid-Text für eine Umgebung, die ihn rendert.

RouteRückgabe
/api/v1/links/{slug}Die Links des Artikels zu anderen Artikeln in Lesereihenfolge, jeweils mit Linktext und Satz.
/api/v1/backlinks/{slug}?page=Die Artikel, die auf ihn verlinken, 30 pro Seite, die wichtigsten zuerst, mit ihrem Linktext.
/api/v1/path?from=&to=Die kürzeste Kette von Links zwischen zwei Artikeln (höchstens 6 Schritte, möglichst unter Umgehung stark vernetzter Knoten), mit dem Satz, der den jeweiligen Schritt herstellt. Der MCP-Server nennt sie connect.
/api/v1/compare?a=&b=Zwei Artikel nebeneinander: Einleitungen, Themenpfade, das tiefste gemeinsame Thema, die Kette zwischen ihnen, gemeinsame und jeweils eigene Links sowie ihre Tabellen mit Eckdaten.
/api/v1/graph/{slug}?depth=1|2&limit=Bis zu limit (Standard: 50, höchstens 200) seiner wichtigsten Nachbarn und alle Links zwischen ihnen. complete: false bedeutet hier sowie bei backlinks und rank/top, dass die Antwort wegen des Zeitlimits der Route von etwa einer Sekunde gekürzt wurde; eine solche Antwort wird nur eine Minute lang im Cache gespeichert.
POST /api/v1/context{ "ids": [...] }, bis zu 50 IDs oder Adressen (wie sie auch /rank?ids= und /leads?ids= entgegennehmen): die Links zwischen ihnen, die Artikel, mit denen die meisten von ihnen durch Links verbunden sind, das tiefste gemeinsame Thema und der tiefste gemeinsame Ort sowie ihre jeweiligen Einleitungen.
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=Wichtigkeit nach PageRank: pr ergibt über den gesamten Korpus summiert 1, Rang 1 bezeichnet den zentralsten Artikel. Beachten Sie die Namen: importance bei /search und Artikeln ist dieser Rang als Perzentil von 0 bis 1; importance bei /resolve ist der Rohwert von pr, und bei /leads ist es { pr, rank }.
/api/v1/timeline?topic=|geo=&from=&to=Sätze mit Datumsangaben aus den Artikeln eines Themas oder Ortes, die ältesten zuerst, 50 pro Seite; Jahreszahlen vor Christus sind negativ. Ein Knoten enthält höchstens 200 über seine Datumsangaben verteilte Ereignisse; from und to filtern diese Auswahl. Ist diese Obergrenze erreicht, nennt die Antwort sampled: true und ihr cap; ihr total zählt die Auswahl.
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}Ereignisse an einem Tag des Jahres (standardmäßig heute nach UTC) oder in einem Jahr (-9999 bis 2100). Ein Tag enthält höchstens 500 Ereignisse, ein Jahr 2.000; ist diese Grenze erreicht, wird sampled: true angegeben.
/api/v1/featured?date=, /api/v1/featured.xmlDen Artikel des Tages (auf der Startseite unter „Fakt des Tages“) und einen Atom-Feed der letzten zehn Tage.
/api/v1/list?topic=|geo=&period=&type=personArtikel eines Themas oder eines Ortes und Zeitraums (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), 30 pro Seite; type=person beschränkt die Auswahl auf Personen. Die Zeilen einer geografischen Liste enthalten geo, aber kein id (rufen Sie dafür den Artikel ab).
/api/v1/keyterms?topic=|geo=&limit=Titel und andere Namen für einen Teilbaum, um eine Spracherkennung vorzubereiten.
/api/v1/stats?topic=|geo=&by=periodNur Zahlen: Artikel, Links und andere Namen für den Korpus oder einen Knoten und seine untergeordneten Knoten. Hier zählt articles unterschiedliche Artikel; bei /geo und /trees/geo zählt es Zuordnungen, sodass ein Artikel in zwei Zeiträumen einer Region dort doppelt zählt.

Auffinden und weitere Protokolle

Generierte Dateien

Aus /openapi.json erzeugt, sodass sie stets damit übereinstimmen.

DateiInhalt
/openapi-3.0.jsonDieselbe Beschreibung in OpenAPI 3.0.3, für Werkzeuge, die 3.1 nicht lesen können.
/arazzo.jsonEin Arazzo-1.0-Workflow: suchen, den besten Treffer abrufen, dann die zugehörigen Artikel.
/tools.jsonJede JSON-Route als Funktion, die ein Modell aufrufen kann, in den Formaten von OpenAI, Anthropic und Gemini sowie als JSON Schema mit ihrer Route.
/edgepedia.d.tsTypeScript-Typen für jede Antwort und die Parameter jeder Route.
/edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.httpJe eine Beispielanfrage pro Route für Postman, Bruno, Insomnia und VS Code oder JetBrains.

Bitte senden Sie wie in den Sammlungen einen User-Agent, der Ihr Programm nennt (edgepedia-collection/1).