edgepedia

Edgepedia

API Edgepedia

Ponad 500 000 artykułów encyklopedycznych, a ich liczba stale rośnie — w formacie JSON. Bezpłatnie. Bez klucza i rejestracji. Użytek komercyjny z podaniem źródła. Trenowanie AI dozwolone dla wszystkich.

Wypróbuj

Endpointy służące do odczytu korzystają z metody GET; migracja, operacje wsadowe i przesyłanie tekstu — z POST. Każdy endpoint zwraca JSON dowolnemu programowi lub stronie internetowej (CORS dopuszcza każde źródło). Opis do odczytu maszynowego: /openapi.json, z przykładową odpowiedzią dla każdego endpointu; ten sam opis w formacie OpenAPI 3.0, definicje funkcji dla modeli, typy TypeScript i kolekcje żądań znajdują się poniżej, w sekcji Wygenerowane pliki.

Karty artykułów

Wygląd

Wybrano: Cantor's diagonal argument

Podgląd

Tytuł artykułu, pełne streszczenie i informacja o źródle — Edgepedia — w formie karty do umieszczenia na Twojej stronie.

/embed/{id}?theme=auto udostępnia kartę na podstawie kanonicznego identyfikatora artykułu. Dostępne warianty wyglądu to auto, light i dark. Opcjonalny skrypt /assets/edgepedia-embed.js dopasowuje ramkę do jej zawartości; bez niego ramka pozostaje czytelna i można ją przewijać.

Działa również /embed/{slug}: przekierowuje do karty pod identyfikatorem artykułu, zachowując motyw. Edgepedia jest też dostawcą oEmbed: GET /oembed?url={article or card URL}&format=json zwraca jako html ten sam kod osadzania co powyższy kreator, wraz z tytułem, szerokością i wysokością; uwzględnia maxwidth i maxheight. Każda strona artykułu z korpusu General zawiera w swoim <head> odsyłacz do adresu oEmbed, dzięki czemu WordPress, Discourse i inne systemy obsługujące oEmbed zamieniają wklejony link do Edgepedii w kartę.

Endpointy

EndpointZwracane dane
/api/v1/search?q=wordsDopasowania tytułów i innych nazw, od najlepszych. Szukaj nazwy tematu, nie zadawaj pytania. Każdy wynik zawiera: identyfikator, tytuł, temat najwyższego poziomu, tekst podglądu, linki i sposób dopasowania (match, confidence). Słowa będące nazwą tematu, np. „pisarze science fiction”, zwracają też topics, czyli link do należących do niego artykułów. limit określa liczbę wyników na stronie, od 1 do 30 (domyślnie 10); page pozwala przechodzić między stronami, a strona poza zakresem jest pusta. Działają też inne nazwy i nazwy z literówkami: „zhu yuanzhang” znajduje cesarza Hongwu, a „siddartha” zwraca did_you_mean. Więcej opcji poniżej, w sekcji Wyszukiwanie.
/api/v1/articles/{slug}Artykuł w formacie Markdown, jego ścieżkę w drzewie kategorii, pozycje w drzewie geograficznym (geo), datę ostatniej aktualizacji i informację o źródle do wyświetlenia. Działa dowolna nazwa (Mount_Fuji, tytuł, pełny adres), a opcje pozwalają uzyskać sekcję, konspekt, fragmenty lub inne formy danych: zob. poniżej Odczyt artykułu.
/api/v1/articles?id={id}To samo, według identyfikatora. Stare identyfikatory artykułów nadal prowadzą do treści po migracji korpusu; identyfikatory kategorii mogą się zmienić przy przebudowie drzewa. Adres może się zmienić; stary nadal zwraca odpowiedź, z moved_from. ids= przyjmuje do 10 identyfikatorów naraz.
/api/v1/leads?ids={id},{id}Do 50 artykułów według identyfikatora, każdy w postaci wyniku wyszukiwania (identyfikator, tytuł, kategoria najwyższego poziomu, tekst podglądu, linki), na potrzeby strony z kartami. Identyfikatory przeniesione lub scalone zwracają artykuł docelowy pod kluczem odpowiadającym żądanemu identyfikatorowi; id wyniku jest identyfikatorem kanonicznym. Identyfikatory nieznane lub niedostępne są pomijane.
/api/v1/randomJeden losowy artykuł. new=1 wybiera spośród najnowszych artykułów; topic= lub geo= wybiera z gałęzi pod danym węzłem.
/api/v1/related/{slug}Artykuły sąsiadujące w jednym wywołaniu: do 10 najbliższych w tej samej kategorii, po 3 z maksymalnie 8 sąsiednich kategorii oraz do 10 najbliższych w każdym węźle geograficznym, do którego należy artykuł. Także ?id={id}. by=links zwraca zamiast tego artykuły cytowane wraz z nim.
/api/v1/topicsSzczyt drzewa tematów.
/api/v1/topics/{id}Ścieżkę tematu, jego podtematy z liczbami artykułów oraz wszystkie należące do niego artykuły, po 30 na stronę. format=mermaid przedstawia jego poddrzewo.
/api/v1/geoDrzewo geograficzne: regiony, każdy ze swoimi okresami.
/api/v1/geo/{id}Węzeł geograficzny o strukturze takiej jak kategoria: jego ścieżkę, węższe węzły i artykuły, po 30 na stronę. Region zawiera jedynie listę swoich okresów.
POST /api/v1/ids/translatePrzy włączonej migracji v1.5: wyślij {"ids":["old-id", "another-id"]} (do 500 różnych identyfikatorów). Odpowiedź przyporządkowuje przeniesionym identyfikatorom ich kanoniczne identyfikatory docelowe; identyfikatory niezmienione lub nieznane są pomijane. Zapisuj punkty kontrolne po ukończeniu kolejnych partii i stosuj się do Retry-After.

Tekst podglądu wykorzystuje fragment z korpusu, jeśli jest dostępny, a w przeciwnym razie początek artykułu. Rekordy i wyniki mające taki fragment zawierają go również jako snippet; markdown pozostaje pełnym tekstem artykułu. node, jeśli występuje, oznacza aktualny węzeł artykułu w drzewie pojęć.

Każdy artykuł jest również dostępny w formacie Markdown pod własnym adresem. Dodaj .md: www.edgepedia.org/koala.md.

Serwer MCP

https://www.edgepedia.org/mcp. Dodaj go do Claude jako niestandardowy konektor, do ChatGPT z włączonym trybem deweloperskim, do VS Code lub Cursor jednym kliknięciem albo do dowolnego innego klienta MCP, podając jego adres. Bez klucza i logowania. Pięć narzędzi tylko do odczytu: search (przyjmuje nazwę tematu, zwraca pasujące artykuły, a także kategorię, jeśli podane słowa są jej nazwą), fetch (jeden artykuł w formacie Markdown, z informacją o źródle, ścieżką kategorii i danymi geograficznymi; citations: false daje tekst krótszy o około jedną czwartą; identyfikator topic: zwraca kategorię nadrzędną, węższe kategorie i artykuły, po 120 na page; topic:root i topic:geo to szczyty drzew kategorii i geograficznego), related (artykuły sąsiadujące w tej samej kategorii, pobliskich kategoriach i drzewie geograficznym; by: "links" daje artykuły cytowane wraz z nim), connect (from, to: łańcuch linków między dwoma artykułami, w postaci zwracanej przez /api/v1/path) oraz resolve (name, z opcjonalnymi context i type: artykuł, do którego najprawdopodobniej odnosi się nazwa, w postaci zwracanej przez /api/v1/resolve). Gdy search nie znajduje pasującego tytułu, za dopasowaniami tytułów pojawiają się artykuły z dopasowaniem w tekście, oznaczone match: fulltext, mieszczące się w limicie limit i wliczane do pages. Błąd narzędzia jest tekstem odczytywanym przez model (z identyfikatorami did_you_mean w przypadku identyfikatora, którego nie ma żaden artykuł); jego kod jest przekazywany w _meta["ai.edgechat/error"], nigdy w structuredContent. fetch z links: "in" przyjmuje links_page, aby pobrać kolejnych 30 artykułów zawierających link do danego artykułu.

search przyjmuje limit (od 1 do 30, domyślnie 10), page, first, topic i sort, a zwraca page i pages; fetch przyjmuje opisane poniżej opcje artykułu oraz ids do pobierania kilku artykułów naraz. Każdy wynik zawiera canonical_id, czyli stały identyfikator artykułu: fetch go przyjmuje, a gdy zapisany przez Ciebie identyfikator lub adres został przeniesiony, fetch zwraca artykuł z moved_from ustawionym na wartość podaną w żądaniu. Wyniki wskazują wydanie korpusu w _meta.corpus_version. Klienci korzystający z protokołu w wersji 2025-06-18 lub nowszej otrzymują też po jednym resource_link na artykuł.

Zasoby: edgepedia://article/{slug} (artykuł w formacie Markdown, ten sam tekst co w fetch) oraz edgepedia://topic/{id} (węższe kategorie i artykuły danej kategorii), oba z uzupełnianiem; uzupełnianie podpowiada też tytuły artykułów dla każdego argumentu wskazującego artykuł. Umiejętność agenta jest również udostępniana przez MCP (skills/list, skills/get), jako skill://edgepedia/SKILL.md. GET pod adresem /mcp zwraca kartę serwera w formacie JSON. Klienci akceptujący wyłącznie text/event-stream otrzymują każdą odpowiedź jako pojedyncze zdarzenie SSE message. Skrót sha256 listy narzędzi jest przekazywany w _meta każdej odpowiedzi (ai.edgechat/tools-sha256), dzięki czemu zmiana opisu narzędzia jest widoczna.

Windows (wersja zapoznawcza, kompilacja 26220.7262 lub nowsza): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Wiersze konfiguracji dla wszystkich pozostałych klientów, umiejętność agenta i przykłady: github.com/EdgePlat/edgepedia-mcp.

Nie korzystasz z MCP albo masz klienta obsługującego wyłącznie starszy transport SSE? Udostępnij modelowi dwie funkcje wywołujące /api/v1/search i /api/v1/articles/{slug} albo pobierz gotowe z /tools.json. Adresy starszego transportu (/sse, /mcp/sse) zwracają 404 z treścią wskazującą https://www.edgepedia.org/mcp.

Limity

600 żądań na minutę i 100 000 dziennie na adres IP, zarówno dla API, jak i serwera MCP. Każda odpowiedź podaje oba okna czasowe w RateLimit-Policy. Po przekroczeniu limitów API zwraca 429 z Retry-After i RateLimit; wywołanie narzędzia MCP zwraca błąd narzędzia, którego retry_after podaje liczbę sekund. Liczniki są prowadzone osobno dla każdej instancji serwera, wyznaczają więc pułap, poniżej którego należy pozostać, a nie dokładny pomiar zużycia. Korzystaj z pamięci podręcznej. Tłumaczenie identyfikatorów zlicza każdy żądany identyfikator osobno; partie /leads sprawdzające stare identyfikatory również są rozliczane za każdy stary identyfikator. W pozostałych operacjach wsadowych każdy identyfikator lub nazwa liczy się jako jedno żądanie, a w przypadku adnotowania — każde 1000 znaków.

Licencja

Licencja społecznościowa Edgepedia 1.0: bezpłatnie z podaniem źródła, również do użytku komercyjnego. Trenowanie AI jest dozwolone dla wszystkich, a wyniki generowane przez model nie wymagają podania źródła. W pozostałych zastosowaniach organizacje o przychodach powyżej 100 mln USD lub mające ponad 100 mln użytkowników miesięcznie muszą uzyskać osobną licencję.

Podawanie źródła: wszędzie, gdzie wyświetlasz tekst artykułu, zamieszczaj jego wiersz credit wraz z linkiem. Odpowiedzi zawierające artykuł udostępniają go też w postaci gotowej do wklejenia jako credit_md i credit_html oraz license.spdx (LicenseRef-Edgepedia-Community-1.0). Odpowiedzi API z artykułami oraz odpowiedzi /leads zawierają Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" i X-License: LicenseRef-Edgepedia-Community-1.0.

Aplikacja EdgeChat, jej Edge Apps oraz nasze oprogramowanie są bezpłatne, ale własnościowe: nie udostępniamy kodu źródłowego i nie wolno ich kopiować, modyfikować ani dalej rozpowszechniać (Umowa licencyjna EdgeChat).

Błędy

JSON: { "error": { "code": "not_found", "message": "…" } }. 400 — brak q, 404 — nie znaleziono, 410 — usunięto, 413 — tekst zbyt długi, 429 — zbyt wiele żądań, 503 — spróbuj ponownie. Odpowiedź 404 wskazuje następne wywołanie: hint, next (adres URL), a w przypadku adresu artykułu, pod którym nic nie znaleziono, także did_you_mean z trzema najbliższymi tytułami. Błąd „nie znaleziono” narzędzia MCP fetch zawiera to samo did_you_mean.

Zmiany

Wersja 1 zachowuje swoją strukturę: pola mogą być dodawane, ale nigdy nie są przemianowywane ani usuwane. Zmiany w samej Edgepedii są opisane pod adresem /edgepedia/updates. Gdy wydanie przebudowuje drzewo kategorii, jak miało to miejsce w wersji 1.8.0, przeniesiony identyfikator kategorii zwraca 301 z nowym identyfikatorem, a /api/v1/changes?since=<release> wymienia wszystkie artykuły dodane, zmienione, przeniesione lub usunięte od wskazanego wydania.

/api/v1 podaje corpus_version, corpus_updated i release_notes. Określają one opublikowane wydanie korpusu General i datę jego publikacji, a nie datę ostatniej edycji każdego artykułu. Te same metadane pojawiają się w instrukcjach serwera MCP. Wydania korpusu nie zmieniają wersji oprogramowania API ani MCP. Zawarte tam id_policy określa gwarancje dotyczące identyfikatora: wydanie może zmienić numerację identyfikatorów lub je scalić, jak w wersji 1.5, a stare identyfikatory nadal zwracają odpowiedzi za pośrednictwem 308 i POST /api/v1/ids/translate.

Coś nie działa? Zgłoś problem.

Dokumentacja szczegółowa

Endpointy i pola korzystające z danych pochodnych (istotność, poziom trudności tekstu, linki, daty, inne nazwy i indeks pełnotekstowy) zwracają 503 z Retry-After albo pomijają dane pole, dopóki dane te nie zostaną opublikowane wraz z magazynem danych.

Odczyt artykułu

/api/v1/articles/{slug} i narzędzie MCP fetch przyjmują poniższe opcje; bez nich odpowiedź zawiera cały artykuł.

OpcjaZwracane dane
section={heading}Jedną sekcję wskazaną nagłówkiem lub zawartym w nim słowem (section=etymology znajduje „Name and etymology”; section=lead oznacza wstęp), wraz z jej podsekcjami. Nieznany nagłówek powoduje odpowiedź 404 z sections artykułu.
outline=1outline: wszystkie nagłówki wraz z rozmiarem ich sekcji w tokenach.
max_tokens={n}Tekst skrócony do około n tokenów na granicy sekcji lub akapitu, z tokens_estimate, truncated i next_cursor; przekaż go jako cursor z tym samym max_tokens, aby otrzymać resztę.
length=snippet, length=leadFragment albo tytuł i pierwszy akapit zamiast całego tekstu.
format=text, html, jsonld, turtle, tablesOdpowiedź w postaci zwykłego tekstu, wyrenderowanej treści albo publicznych pól w formacie JSON-LD lub Turtle; tables podaje każdą tabelę jako columns i rows, jako csv oraz z odwołaniami do źródeł przeniesionymi do cites i sources.
chunks=1chunks: artykuł podzielony na akapity, każdy ze stałym identyfikatorem utworzonym na podstawie ścieżki nagłówków (geology-2) oraz z cite_url.
q={words}&k={1–10}passages: k akapitów (domyślnie 3) najlepiej pasujących do podanych słów, każdy z cite_url.
quote={sentence or chunk id}cite_url: adres artykułu z fragmentem tekstowym otwierającym stronę w danym miejscu; quote_found informuje, czy artykuł zawiera ten fragment.
cite={format}cite: opis bibliograficzny artykułu w postaci zwracanej przez /api/v1/cite.

Każda odpowiedź zawierająca artykuł zawiera też speakable (fragment w postaci, którą może odczytać asystent głosowy). importance i rank (PageRank obliczany na podstawie linków między artykułami; 1 oznacza pozycję najbardziej centralną; to miara oparta na liczbie linków, nie ocena opisywanego tematu), words, reading_grade (Flescha–Kincaida) i reading_minutes pojawiają się tylko wtedy, gdy wymienia je fields= (?fields=title,importance,rank); narzędzie MCP fetch zawiera je zawsze. next=1 dodaje do 5 propozycji dalszej lektury. citations=false zastępuje linki do źródeł w tekście znacznikami [n] w markdown, chunks i passages, tak jak robi to citations: false w MCP. Adres, którego nie ma żaden artykuł, jest odczytywany jako identyfikator artykułu (/api/v1/articles/ep7rbwcy0a) albo jego tytuł, bez rozróżniania wielkości liter i znaków diakrytycznych (/api/v1/articles/paris); adres zapisany małymi literami z łącznikami, który nie spełnia tych warunków, zwraca 404, chyba że dodasz ?suggest=1. Natomiast adres z wielkimi literami, spacjami lub podkreśleniami (/api/v1/articles/Albert_Einstein) jest odczytywany jako nazwa, więc przybliżone dopasowanie zwraca najlepszy wynik wyszukiwania z resolved_by: search. Jeśli podana nazwa nie jest adresem artykułu, odpowiedź informuje, jak ją odczytano (resolved_from, resolved_by: adres, tytuł lub wyszukiwanie), i wymienia 3 inne artykuły w nearest. /api/v1/articles?ids={slug or id},{name} zwraca do 10 artykułów jako articles (każdy z nazwą, na którą odpowiada, w asked) oraz missing; każda opcja dotyczy każdego z nich.

Cytowanie artykułu

/api/v1/cite/{slug}?format= udostępnia opis bibliograficzny w formacie csl (CSL-JSON, domyślnie), bibtex, ris, apa, mla, chicago lub harvard, wraz z informacją o źródle jako zwykłym tekstem oraz w formatach Markdown i HTML; /api/v1/cite?ids={id},{slug} robi to samo dla maksymalnie 50 artykułów. Autorem jest Edgepedia (EdgeChat); style APA, MLA, Chicago i Harvard oznaczają kursywę tytułu gwiazdkami, tak jak Markdown. Karty artykułów zawierają ten sam opis bibliograficzny w niewidocznej postaci, jako COinS i JSON-LD, do odczytu przez menedżery bibliografii.

Wyszukiwanie

matchKiedyconfidence
exactTytuł jest identyczny z zapytaniem.1,0 dla pierwszego takiego wyniku, 0,9 dla kolejnego
aliasDopasowano inną nazwę lub inicjały tytułu („mlk”).0,8; 0,7 dla pierwszego wyniku niezawierającego żadnego słowa z zapytania; 0,6 dla zapytania po transliteracji
misspellingWyszukiwarka poprawiła zapytanie (did_you_mean).0,5 × część wpisanego zapytania zachowana po korekcie
partialNiektóre słowa z zapytania występują w tytule albo tylko w tekście.0,2 + 0,5 × odsetek słów z zapytania występujących w tytule; 0,2, jeśli występują tylko w tekście
fulltextNie dopasowano tytułu ani innej nazwy, więc przeszukano tekst artykułów (BM25): opis pozwala znaleźć artykuł, którego nazwy nie znasz.co najmniej 0,2
noneNic nie pasuje. Odpowiedź jest pusta.0

Poziom pewności wynika ze stałej reguły, nie jest skalibrowanym prawdopodobieństwem; jeśli najlepszy wynik ma wartość poniżej 0,2, odpowiedź jest pusta. Każdy wynik zawiera highlight — zdanie ze streszczenia, w którym występuje najwięcej słów z zapytania. Wyszukiwanie, które niczego nie znalazło, jest ponawiane jeden raz z użyciem liter łacińskich (cyrylica, alfabet grecki, kana i hangul podlegają transliteracji, cyfry oznaczające tony w pinyin są pomijane, a podwojone samogłoski w rōmaji — skracane); odpowiedź oznacza je jako searched_as. Znaki chińskie nie podlegają transliteracji.

OpcjaDziałanie
first=trueTylko najlepsze dopasowanie albo żadne.
topic={id}, geo={id}Tylko artykuły pod wskazanym węzłem kategorii lub drzewa geograficznego; geo filtruje wszystkie dopasowania, maksymalnie 1000, a scope informuje o zakresie odpowiedzi.
sort=centralNajpierw tematy, do których prowadzi najwięcej linków, spośród wszystkich dopasowań, maksymalnie 1000.
max_grade={grade}Tylko artykuły o poziomie trudności tekstu nie wyższym niż wskazany poziom szkolny.
facets=1Liczby dopasowań według kategorii najwyższego poziomu i regionu geograficznego, dla wszystkich dopasowań, maksymalnie 1000 (facets.counted).

Każda odpowiedź

fields=a,b zachowuje tylko wskazane klucze każdego wyniku (lub odpowiedzi, jeśli nie ma w niej wyników); obudowa odpowiedzi (total, page, next, license) pozostaje. Odpowiedź 200, którą można zapisać w pamięci podręcznej, zawiera ETag: odeślij tę wartość jako If-None-Match, a jeśli odpowiedź się nie zmieniła, otrzymasz 304 bez treści. Last-Modified to data wydania korpusu, podawana wyłącznie informacyjnie. Edgepedia-Corpus-Version wskazuje wydanie korpusu, a Content-Digest jest skrótem SHA-256 treści odpowiedzi (RFC 9530); .md artykułu również zawiera oba te pola.

Więcej endpointów

EndpointZwracane dane
/api/v1/articles?after={id}&limit={1..1000}Wszystkie artykuły z korpusu General, przeglądane w stałej kolejności: {id, slug, title, api_url} i next (na końcu null). Puste after= rozpoczyna przeglądanie od początku; można je wznowić po dowolnym identyfikatorze, nawet usuniętym.
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoCałe drzewa kategorii i geograficzne: nodes: [[id, label, parent index, own articles]]; identyfikator zaczynający się od kropki jest dalszym ciągiem identyfikatora rodzica.
/api/v1/releasesWydania korpusu, od najnowszego, oraz current.
/api/v1/healthapplication/health+json: pass, warn lub fail (503).
/api/v1/manifestPrzekierowanie do jednego pliku JSONL skompresowanego gzip, z jednym artykułem w wierszu: { id, slug, title, updated, sha256, topic } (sha256 zawartości .md artykułu). Pobierz go raz, aby utworzyć kopię lustrzaną Edgepedii. Suma kontrolna dotyczy opublikowanego tekstu, przed poprawkami zgłoszonymi przez czytelników: artykuł zmieniony od czasu wydania wskutek takiego zgłoszenia nie będzie z nią zgodny aż do następnego wydania.
/api/v1/changes?since={release}Pliki zmian od wskazanego wydania do obecnego, w kolejności (strumień zmian zaczyna się od wersji 1.5: najwcześniejsze jest since=1.5); każdy wiersz ma postać { op, id, … }, a op przyjmuje jedną z wartości: added, changed, moved (from_slug to stary adres) lub removed.
/api/v1/events/{slug}Zdania artykułu zawierające datę: { date, precision, text, para }, date jako YYYY, YYYY-MM lub YYYY-MM-DD (wartości ujemne przed naszą erą: -0044-03-15). Daty p.n.e. są zgodne z konwencją historyczną, nie z astronomiczną numeracją lat: -0044 oznacza 44 r. p.n.e. (standardowy parser ISO 8601 odczytałby tę wartość jako 45 r. p.n.e.). Dowodem jest zdanie: przeczytaj je, zanim uznasz datę za fakt.
/api/v1/aliases/{id}Inne nazwy artykułu, w tym skrótowce wymienione w artykułach („NASA”); pomija błędną pisownię i warianty różniące się wielkością liter, a spośród dwóch zapisów tej samej nazwy zachowuje ten bez kropek („WHO”, nie „W.H.O.”).

Rozpoznawanie nazw, adnotowanie i uzgadnianie encji

Na wejściu dowolny tekst, na wyjściu identyfikatory artykułów — bez modelu i bez osadzeń wektorowych. Tekst przesyłany do adnotowania, klasyfikacji i analizy geograficznej nigdy nie jest zapisywany w logach ani przechowywany.

EndpointZwracane dane
/api/v1/resolve?name=Mercury&context=planetArtykuł, do którego najprawdopodobniej odnosi się nazwa: result, confidence, ambiguous, match (exact, alias, anchor, partial lub none) oraz alternatives. type= ogranicza kandydatów do jednego identyfikatora kategorii (gdy nie należy do niej żaden z pierwszych 30 wyników dla nazwy, żądanie dla pojedynczej nazwy przeszukuje kolejnych 60); limit= od 1 do 10. POST przyjmuje do 50 nazw: { "names": ["Paris", "Koala"] } lub { "queries": [{ "name": "Mercury", "context": "planet" }] }. Jeśli sama nazwa nie wskazuje jednoznacznie artykułu, odpowiedź zawiera ambiguous: true, a w result — najbardziej prawdopodobne dopasowanie; przekaż context, aby dokonać wyboru.
/api/v1/surface?form=mercuryWszystkie artykuły, do których odsyła dokładnie ta fraza w linkach samego korpusu, wraz z liczbą linków i udziałem każdego artykułu (commonness).
/api/v1/suggest?prefix=koaNajpierw artykuł o dokładnie takim tytule, następnie artykuł o dokładnie takiej innej nazwie, potem tytuły zaczynające się od podanego prefiksu, a na końcu inne nazwy zaczynające się od niego (matched podaje tę nazwę); do pól wyszukiwania i interfejsów głosowych.
POST /api/v1/annotate{ "text": "…" } (najwyżej 20 000 znaków): każdą frazę z przypisanym linkiem wraz z jej pozycjami w tekście (start, end, w jednostkach kodowych UTF-16, tak jak JavaScript indeksuje ciągi znaków: w Pythonie znak spoza podstawowej płaszczyzny wielojęzycznej, na przykład emoji, należy liczyć jako dwa), artykułem i poziomem pewności. ?format=html zwraca też tekst ze znakami specjalnymi zastąpionymi encjami HTML i każdą frazą opatrzoną linkiem.
POST /api/v1/classify{ "text": "…" }: kategorie, których dotyczy tekst, z punktacją wyznaczoną na podstawie ścieżek kategorii wspomnianych w nim artykułów, oraz udziały kategorii najwyższego poziomu.
POST /api/v1/geoparse{ "text": "…" }: miejsca i okresy wymienione w tekście, umiejscowione w drzewie geograficznym (nodes, regions, places, periods); niegeograficzna gałąź drzewa (geo.nongeo) nigdy nie jest miejscem.
/api/v1/mentions?term=CRISPRArtykuły, które wspominają dany temat, ale nie odsyłają do poświęconego mu artykułu; complete: false oznacza, że lista artykułów zawierających link została ucięta.
/api/v1/reconcileEndpoint zgodny z Reconciliation Service API 0.2: manifest, wsadowe queries (GET lub POST), podpowiedzi encji, typów i właściwości, podgląd oraz rozszerzanie danych (title, url, excerpt, topic, topic_path, importance_rank). JSONP z callback=. W OpenRefine: Reconcile › Start reconciling › Add standard service, a następnie wklej https://www.edgepedia.org/api/v1/reconcile.

Graf linków, daty i listy

Diagramy (format=mermaid) mają postać tekstu Mermaid do wyrenderowania przez system, który je wyświetla.

EndpointZwracane dane
/api/v1/links/{slug}Linki artykułu do innych artykułów, w kolejności występowania w tekście, każdy z tekstem linku i zdaniem, w którym się znajduje.
/api/v1/backlinks/{slug}?page=Artykuły, które do niego odsyłają, po 30 na stronę, od najważniejszych, wraz z tekstem linku.
/api/v1/path?from=&to=Najkrótszy łańcuch linków między dwoma artykułami (najwyżej 6 przejść, w miarę możliwości z pominięciem węzłów o bardzo wielu połączeniach), wraz ze zdaniem zawierającym każde przejście. Na serwerze MCP nosi nazwę connect.
/api/v1/compare?a=&b=Dwa artykuły obok siebie: wstępy, ścieżki kategorii, najgłębszą wspólną kategorię, łączący je łańcuch, linki wspólne i odrębne oraz tabelę Najważniejsze fakty z każdego z nich.
/api/v1/graph/{slug}?depth=1|2&limit=Do limit (domyślnie 50, najwyżej 200) najważniejszych sąsiadów artykułu oraz wszystkie linki między nimi. complete: false (tutaj, przy linkach przychodzących i przy rank/top) oznacza, że odpowiedź została skrócona z powodu wynoszącego około sekundy limitu czasu endpointu; taka odpowiedź jest przechowywana w pamięci podręcznej tylko przez minutę.
POST /api/v1/context{ "ids": [...] }, do 50 identyfikatorów lub adresów (przyjmowanych również przez /rank?ids= i /leads?ids=): linki między nimi, artykuły połączone linkami z większością z nich, najgłębszą wspólną kategorię i wspólne miejsce oraz wstęp każdego artykułu.
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=Istotność według PageRank: suma pr w całym korpusie wynosi 1, a pozycja 1 oznacza artykuł najbardziej centralny. Uwaga na nazwy: importance w /search i artykułach to ta pozycja wyrażona jako percentyl w skali od 0 do 1; importance w /resolve jest surową wartością pr, a w /leads — { pr, rank }.
/api/v1/timeline?topic=|geo=&from=&to=Zdania z datami pochodzące z artykułów danej kategorii lub miejsca, od najstarszych, po 50 na stronę; lata p.n.e. mają wartości ujemne. Węzeł zachowuje najwyżej 200 zdarzeń rozłożonych w swoim zakresie dat, a from i to filtrują tę próbkę; odpowiedź pochodząca z próbki, która osiągnęła ten limit, zawiera sampled: true oraz jej cap, a total podaje liczebność próbki.
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}Zdarzenia z danego dnia roku (domyślnie z dzisiejszego dnia według UTC) albo z jednego roku (od -9999 do 2100). Dzień obejmuje najwyżej 500 zdarzeń, a rok — 2000; po osiągnięciu limitu odpowiedź zawiera sampled: true.
/api/v1/featured?date=, /api/v1/featured.xmlWyróżniony artykuł dnia (Ciekawostka na dziś na stronie głównej) oraz kanał Atom z ostatnich dziesięciu dni.
/api/v1/list?topic=|geo=&period=&type=personArtykuły danej kategorii albo danego miejsca i okresu (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), po 30 na stronę; type=person pozostawia tylko osoby. Wiersze listy geograficznej zawierają geo, ale nie id (aby je uzyskać, pobierz artykuł).
/api/v1/keyterms?topic=|geo=&limit=Tytuły i inne nazwy z poddrzewa, do wstępnego przygotowania systemu rozpoznawania mowy.
/api/v1/stats?topic=|geo=&by=periodTylko liczby: artykułów, linków i innych nazw w korpusie albo węźle i jego dzieciach. Tutaj articles liczy odrębne artykuły; w /geo i /trees/geo liczy przypisania, więc artykuł należący do dwóch okresów w regionie jest tam liczony dwukrotnie.

Odkrywanie i inne protokoły

Wygenerowane pliki

Tworzone na podstawie /openapi.json, więc zawsze pozostają z nim zgodne.

PlikZawartość
/openapi-3.0.jsonTen sam opis w formacie OpenAPI 3.0.3, dla narzędzi, które nie odczytują wersji 3.1.
/arazzo.jsonPrzepływ pracy w formacie Arazzo 1.0: wyszukanie, pobranie najlepszego dopasowania, a następnie powiązanych z nim artykułów.
/tools.jsonKażdy endpoint JSON jako funkcja, którą może wywołać model, w formatach OpenAI, Anthropic i Gemini, a także jako JSON Schema wraz z endpointem.
/edgepedia.d.tsTypy TypeScript dla każdej odpowiedzi i parametrów każdego endpointu.
/edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.httpPo jednym przykładowym żądaniu na endpoint dla narzędzi Postman, Bruno, Insomnia oraz VS Code lub JetBrains.

Przesyłaj User-Agent z nazwą swojego programu, tak jak w kolekcjach (edgepedia-collection/1).