API Edgepedia
Lebih dari 500.000 artikel ensiklopedia dan terus bertambah, dalam format JSON. Gratis. Tanpa kunci, tanpa pendaftaran. Penggunaan komersial diperbolehkan dengan atribusi. Pelatihan AI terbuka bagi semua orang.
Coba
- www.edgepedia.org/api/v1/search?q=koala
- www.edgepedia.org/api/v1/articles/koala
- www.edgepedia.org/api/v1/random
- www.edgepedia.org/api/v1/topics
Rute baca menggunakan GET; migrasi, pemrosesan batch, dan teks yang Anda kirim menggunakan POST. Setiap rute mengembalikan JSON ke program atau halaman web apa pun (CORS mengizinkan semua asal). Deskripsi yang dapat dibaca mesin: /openapi.json, dengan contoh respons untuk setiap rute; deskripsi yang sama dalam OpenAPI 3.0, definisi fungsi untuk model, tipe TypeScript, dan koleksi permintaan tercantum di bagian Berkas yang dihasilkan, di bawah.
Kartu referensi
Dipilih: Cantor's diagonal argument
Judul artikel, ringkasan lengkap, dan atribusi Edgepedia dalam satu kartu untuk situs web Anda.
/embed/{id}?theme=auto menyajikan kartu berdasarkan ID kanonis artikelnya. Tampilannya dapat berupa auto, light, atau dark. Skrip opsional /assets/edgepedia-embed.js menyesuaikan bingkai dengan isinya; tanpa skrip ini, bingkai tetap dapat dibaca dan digulir.
/embed/{slug} juga bisa digunakan: alamat ini mengarahkan ke kartu pada ID artikel tersebut, dengan tetap mempertahankan temanya. Edgepedia juga merupakan penyedia oEmbed: GET /oembed?url={article or card URL}&format=json mengembalikan kode sematan yang sama dengan pembuat kartu di atas dalam bentuk html, beserta judul, lebar, dan tingginya; maxwidth dan maxheight diperhitungkan. Setiap halaman artikel General menautkan alamat oEmbed-nya di dalam <head>, sehingga WordPress, Discourse, dan aplikasi penerima oEmbed lainnya mengubah tautan Edgepedia yang ditempelkan menjadi kartu.
Rute
| Rute | Hasil |
|---|---|
/api/v1/search?q=words | Mencocokkan judul dan nama lain, dengan hasil terbaik di urutan pertama. Cari nama suatu subjek, bukan pertanyaan. Setiap hasil memuat: id, judul, topik tingkat teratas, teks pratinjau, tautan, dan cara pencocokannya (match, confidence). Kata-kata yang menyebut suatu topik, seperti "science fiction writers", juga mengembalikan topics, yaitu tautan ke artikel-artikel dalam topik tersebut. limit adalah jumlah hasil per halaman, 1 hingga 30 (nilai bawaan 10); page digunakan untuk berpindah halaman, dan halaman setelah hasil terakhir akan kosong. Nama lain dan ejaan yang keliru juga dapat digunakan: "zhu yuanzhang" menemukan Kaisar Hongwu, dan "siddartha" mengembalikan did_you_mean. Opsi lainnya: Pencarian, di bawah. |
/api/v1/articles/{slug} | Artikel dalam format Markdown, jalur topiknya, posisinya dalam pohon geografi (geo), tanggal pembaruan terakhirnya, dan baris atribusi yang harus ditampilkan. Nama apa pun dapat digunakan (Mount_Fuji, judul, alamat lengkap), dan opsi yang tersedia dapat mengembalikan bagian, kerangka, petikan, atau bentuk lainnya: Membaca artikel, di bawah. |
/api/v1/articles?id={id} | Hasil yang sama, berdasarkan id. ID artikel lama tetap mengarah ke artikel setelah migrasi korpus; ID topik dapat berubah saat pohonnya direvisi. Alamat dapat berpindah; alamat lama tetap memberikan respons, disertai moved_from. ids= menerima hingga 10 sekaligus. |
/api/v1/leads?ids={id},{id} | Hingga 50 artikel berdasarkan id, masing-masing dalam bentuk hasil pencarian (id, judul, topik tingkat teratas, teks pratinjau, tautan), untuk satu halaman kartu. ID yang dimigrasikan dan digabungkan mengembalikan artikel yang dipertahankan, dengan ID yang diminta sebagai kuncinya; id dalam hasil tersebut adalah ID kanonis. ID yang tidak dikenal atau tidak tersedia tidak disertakan. |
/api/v1/random | Satu artikel acak. new=1 memilih dari artikel-artikel terbaru; topic= atau geo= memilih dari bawah suatu simpul. |
/api/v1/related/{slug} | Artikel-artikel tetangga dalam satu panggilan: hingga 10 artikel terdekat dalam topik yang sama, 3 artikel dari masing-masing maksimal 8 topik tetangga, dan hingga 10 artikel terdekat dalam setiap simpul geografi tempat artikel itu berada. Juga ?id={id}. Sebagai gantinya, by=links memberikan artikel-artikel yang dikutip bersamanya. |
/api/v1/topics | Puncak pohon topik. |
/api/v1/topics/{id} | Jalur suatu topik, subtopiknya beserta jumlah artikel, dan semua artikel di bawahnya, 30 per halaman. format=mermaid menggambar subpohonnya. |
/api/v1/geo | Pohon geografi: wilayah-wilayahnya, masing-masing beserta periode-periode waktunya. |
/api/v1/geo/{id} | Simpul geografi, dengan struktur seperti topik: jalurnya, simpul-simpul yang lebih spesifik, dan artikel-artikelnya, 30 per halaman. Wilayah hanya mencantumkan periode-periode waktunya. |
POST /api/v1/ids/translate | Jika migrasi v1.5 diaktifkan: kirim {"ids":["old-id", "another-id"]} (hingga 500 ID berbeda). Respons memetakan ID yang berpindah ke ID kanonis yang dipertahankan; ID yang tidak berubah atau tidak dikenal tidak disertakan. Simpan titik pemeriksaan untuk batch yang telah selesai dan patuhi Retry-After. |
Teks pratinjau menggunakan cuplikan dari korpus jika tersedia, dan bagian pembuka artikel jika tidak. Rekaman dan hasil yang memiliki cuplikan juga menyertakannya sebagai snippet; markdown tetap berisi teks artikel lengkap. node, jika ada, adalah simpul artikel saat ini dalam pohon konsep.
Setiap artikel juga tersedia sebagai Markdown di alamatnya sendiri. Tambahkan .md: www.edgepedia.org/koala.md.
Server MCP
https://www.edgepedia.org/mcp. Tambahkan ke Claude sebagai konektor khusus, ke ChatGPT dengan mode Pengembang diaktifkan, ke VS Code atau Cursor dengan satu klik, atau ke klien MCP lainnya melalui alamatnya. Tanpa kunci, tanpa masuk akun. Lima alat hanya-baca: search (menerima nama subjek, mengembalikan artikel yang cocok, serta topik jika kata-katanya menyebut suatu topik), fetch (satu artikel dalam format Markdown, beserta baris atribusi, jalur topik, dan geografinya; citations: false untuk teks yang sekitar seperempat lebih pendek; ID topic: mencantumkan induk topik tersebut, topik-topik yang lebih spesifik, dan artikel-artikelnya, 120 per page; topic:root dan topic:geo adalah puncak pohon topik dan pohon geografi), related (artikel-artikel tetangga dalam topik yang sama, topik sekitar, dan geografinya; by: "links" untuk artikel-artikel yang dikutip bersamanya), connect (from, to: rantai tautan antara dua artikel, seperti yang diberikan oleh /api/v1/path), dan resolve (name, dengan context dan type opsional: artikel yang paling mungkin dimaksud oleh suatu nama, seperti yang diberikan oleh /api/v1/resolve). Jika tidak ada judul yang cocok dengan search, artikel yang teksnya cocok ditempatkan setelah hasil pencocokan judul, ditandai dengan match: fulltext, tetap dalam batas limit dan dihitung dalam pages. Kesalahan alat berupa teks yang dibaca model (dengan ID did_you_mean untuk ID yang tidak dimiliki artikel mana pun); kodenya disertakan dalam _meta["ai.edgechat/error"], bukan structuredContent. fetch dengan links: "in" menerima links_page untuk 30 artikel berikutnya yang menaut ke sana.
search menerima limit (1 hingga 30, nilai bawaan 10), page, first, topic, dan sort, serta mengembalikan page dan pages; fetch menerima opsi artikel di bawah serta ids untuk beberapa artikel sekaligus. Setiap hasil menyertakan canonical_id, yaitu ID permanen artikel: fetch menerima ID tersebut, dan jika ID atau alamat yang Anda simpan telah berpindah, fetch mengembalikan artikel dengan moved_from diisi sesuai ID atau alamat yang Anda minta. Hasil menyebutkan rilis korpus dalam _meta.corpus_version. Klien yang menggunakan protokol 2025-06-18 atau yang lebih baru juga mendapatkan satu resource_link per artikel.
Sumber daya: edgepedia://article/{slug} (artikel dalam format Markdown, dengan teks yang sama seperti fetch) dan edgepedia://topic/{id} (topik-topik yang lebih spesifik beserta artikel-artikel dalam suatu topik), keduanya mendukung pelengkapan; pelengkapan juga menyarankan judul artikel untuk setiap argumen yang menyebut artikel. Agent Skill juga disajikan melalui MCP (skills/list, skills/get), sebagai skill://edgepedia/SKILL.md. Permintaan GET ke /mcp mengembalikan kartu server dalam format JSON. Klien yang hanya menerima text/event-stream mendapatkan setiap respons sebagai satu peristiwa SSE message. Nilai sha256 daftar alat disertakan dalam _meta pada setiap respons (ai.edgechat/tools-sha256), sehingga perubahan pada deskripsi alat dapat diketahui.
Windows (pratinjau, build 26220.7262 atau yang lebih baru): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Baris konfigurasi untuk semua klien lainnya, Agent Skill, dan contoh: github.com/EdgePlat/edgepedia-mcp.
Tidak menggunakan MCP, atau klien Anda hanya mendukung transport SSE lama? Berikan dua fungsi kepada model Anda untuk memanggil /api/v1/search dan /api/v1/articles/{slug}, atau ambil fungsi siap pakai dari /tools.json. Alamat transport lama (/sse, /mcp/sse) memberikan respons 404 dengan isi yang menyebutkan https://www.edgepedia.org/mcp.
Batas
600 permintaan per menit dan 100.000 per hari untuk setiap alamat IP, baik untuk API maupun server MCP. Setiap respons menyebutkan kedua rentang waktu tersebut dalam RateLimit-Policy. Setelah batas terlampaui, API memberikan respons 429 dengan Retry-After dan RateLimit; panggilan alat MCP mengembalikan kesalahan alat dengan retry_after yang menyatakan jumlah detiknya. Penghitungan dilakukan per instans server, jadi angka tersebut merupakan batas atas yang harus dihindari, bukan pengukur yang persis. Harap gunakan cache. Penerjemahan ID (POST /api/v1/ids/translate) menghitung setiap ID yang diminta secara terpisah; batch /leads yang memeriksa ID lama juga dihitung per ID lama. Batch lainnya menghitung setiap ID atau nama sebagai satu permintaan, sedangkan anotasi dihitung satu permintaan per 1.000 karakter.
Lisensi
Lisensi Komunitas Edgepedia 1.0: gratis dengan atribusi, termasuk untuk penggunaan komersial. Pelatihan AI terbuka bagi semua orang, dan keluaran model tidak memerlukan atribusi. Untuk penggunaan lain, organisasi dengan pendapatan di atas USD 100 juta atau lebih dari 100 juta pengguna bulanan harus memperoleh lisensi tersendiri.
Atribusi: tampilkan baris credit setiap artikel, beserta tautannya, di mana pun Anda menampilkan teks artikel itu. Respons artikel juga menyertakannya dalam bentuk siap tempel sebagai credit_md dan credit_html, serta license.spdx (LicenseRef-Edgepedia-Community-1.0). Respons API dari rute artikel dan rute /leads menyertakan Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" dan X-License: LicenseRef-Edgepedia-Community-1.0.
Aplikasi EdgeChat, Edge Apps di dalamnya, dan perangkat lunak kami tersedia gratis tetapi bersifat proprieter: kode sumber tidak disediakan, dan semuanya tidak boleh disalin, dimodifikasi, atau didistribusikan ulang (Perjanjian Lisensi EdgeChat).
Kesalahan
JSON: { "error": { "code": "not_found", "message": "…" } }. 400 tidak menyertakan q, 404 tidak ditemukan, 410 dihapus, 413 teks terlalu panjang, 429 terlalu banyak permintaan, 503 coba lagi. Respons 404 menyebutkan panggilan berikutnya: hint, next (URL), dan, untuk alamat artikel yang tidak memberikan hasil, did_you_mean dengan tiga judul terdekat. Kesalahan tidak ditemukan pada alat MCP fetch menyertakan did_you_mean yang sama.
Perubahan
Versi 1 mempertahankan strukturnya: field dapat ditambahkan, tetapi tidak akan diubah namanya atau dihapus. Perubahan pada Edgepedia sendiri tersedia di /edgepedia/updates. Jika suatu rilis menata ulang pohon topik, seperti pada versi 1.8.0, ID topik yang berpindah memberikan respons 301 dengan ID barunya, dan /api/v1/changes?since=<release> mencantumkan setiap artikel yang ditambahkan, diubah, dipindahkan, atau dihapus sejak rilis tersebut.
/api/v1 melaporkan corpus_version, corpus_updated, dan release_notes. Ketiganya menunjukkan rilis korpus General yang dipublikasikan beserta tanggal rilisnya, bukan tanggal terakhir setiap artikel disunting. Metadata yang sama muncul dalam instruksi server MCP. Rilis korpus tidak mengubah versi perangkat lunak API atau MCP. id_policy di sana menjelaskan jaminan yang berlaku bagi ID: nomor ID dapat diubah atau ID dapat digabungkan oleh suatu rilis, seperti pada versi 1.5, dan ID lama tetap memberikan respons, melalui 308 dan POST /api/v1/ids/translate.
Ada yang tidak berfungsi? Laporkan.
Referensi
Rute dan field yang membaca data turunan (tingkat kepentingan, jenjang keterbacaan, tautan, tanggal, nama lain, dan indeks teks lengkap) memberikan respons 503 dengan Retry-After, atau tidak menyertakan field tersebut, sampai data itu dipublikasikan bersama penyimpanan datanya.
Membaca artikel
/api/v1/articles/{slug} dan MCP fetch menerima opsi berikut; tanpa opsi ini, responsnya adalah seluruh artikel.
| Opsi | Hasil |
|---|---|
section={heading} | Satu bagian, berdasarkan judul bagiannya atau salah satu kata di dalamnya (section=etymology menemukan "Name and etymology"; section=lead adalah bagian pembuka), beserta subbagiannya. Judul bagian yang tidak dikenal memberikan respons 404 dengan sections artikel tersebut. |
outline=1 | outline: semua judul bagian beserta ukurannya dalam token. |
max_tokens={n} | Teks yang dipotong hingga sekitar n token pada batas bagian atau paragraf, disertai tokens_estimate, truncated, dan next_cursor; kirimkan sebagai cursor dengan max_tokens yang sama untuk mendapatkan sisanya. |
length=snippet, length=lead | Cuplikan, atau judul dan paragraf pembuka, sebagai pengganti teks lengkap. |
format=text, html, jsonld, turtle, tables | Respons dalam bentuk teks biasa, isi yang telah dirender, atau field publiknya dalam format JSON-LD atau Turtle; tables menyajikan setiap tabel sebagai columns dan rows, sebagai csv, serta dengan kutipannya dipindahkan ke cites dan sources. |
chunks=1 | chunks: artikel dalam bentuk paragraf, masing-masing dengan ID tetap yang berasal dari jalur judul bagiannya (geology-2) dan sebuah cite_url. |
q={words}&k={1–10} | passages: k paragraf (nilai bawaan 3) yang paling cocok dengan kata-kata yang diberikan, masing-masing disertai cite_url. |
quote={sentence or chunk id} | cite_url: alamat artikel dengan fragmen teks yang membuka halaman pada petikan tersebut; quote_found menyatakan apakah artikel itu memuatnya. |
cite={format} | cite: referensi ke artikel, seperti yang diberikan oleh /api/v1/cite. |
Setiap respons artikel juga memuat speakable (cuplikan yang dapat dibacakan oleh asisten suara). importance dan rank (PageRank berdasarkan tautan antarartikel; 1 adalah yang paling sentral; ukuran berdasarkan jumlah tautan, bukan penilaian terhadap subjeknya), words, reading_grade (Flesch-Kincaid), dan reading_minutes hanya disertakan jika disebutkan dalam fields= (?fields=title,importance,rank); MCP fetch selalu menyertakannya. next=1 menambahkan hingga 5 artikel untuk dibaca selanjutnya. citations=false mengganti tautan sumber di dalam teks dengan penanda [n], dalam markdown, chunks, dan passages, seperti yang dilakukan oleh citations: false pada MCP. Alamat yang tidak dimiliki artikel mana pun dibaca sebagai ID artikel (/api/v1/articles/ep7rbwcy0a) atau judulnya, tanpa membedakan huruf besar-kecil dan aksen (/api/v1/articles/paris); alamat berhuruf kecil dengan tanda hubung yang tidak cocok dengan keduanya memberikan respons 404 kecuali Anda menambahkan ?suggest=1, sedangkan alamat dengan huruf kapital, spasi, atau garis bawah (/api/v1/articles/Albert_Einstein) dibaca sebagai nama, sehingga nama yang hampir cocok mengembalikan hasil pencarian terbaik dengan resolved_by: search. Jika nama yang Anda berikan bukan alamat artikel tersebut, respons menjelaskan cara nama itu dibaca (resolved_from, resolved_by: alamat, judul, atau pencarian) dan mencantumkan 3 artikel lain dalam nearest. /api/v1/articles?ids={slug or id},{name} mengembalikan hingga 10 artikel sebagai articles (masing-masing dengan nama yang diminta sebagai asked) dan missing; setiap opsi berlaku untuk masing-masing artikel.
Mengutip artikel
/api/v1/cite/{slug}?format= memberikan referensi dalam format csl (CSL-JSON, nilai bawaan), bibtex, ris, apa, mla, chicago, atau harvard, beserta baris atribusi dalam bentuk teks, Markdown, dan HTML; /api/v1/cite?ids={id},{slug} memberikan hasil yang sama untuk hingga 50 artikel. Penulisnya adalah Edgepedia (EdgeChat); APA, MLA, Chicago, dan Harvard menandai judul yang dicetak miring dengan tanda bintang, seperti dalam Markdown. Kartu referensi memuat kutipan yang sama secara tak terlihat, dalam bentuk COinS dan JSON-LD, untuk perangkat lunak pengelola referensi.
Pencarian
match | Kondisi | confidence |
|---|---|---|
exact | Judul sama dengan kueri. | 1,0 untuk hasil pertama yang demikian, 0,9 untuk hasil berikutnya |
alias | Nama lain, atau inisial judul ("mlk"), cocok. | 0,8; 0,7 untuk hasil pertama yang tidak memuat satu kata pun dari kueri; 0,6 untuk kueri yang ditransliterasi |
misspelling | Pencarian mengoreksi kueri (did_you_mean). | 0,5 × proporsi kueri yang diketik yang tetap dipertahankan setelah koreksi |
partial | Sebagian kata kueri terdapat dalam judul, atau hanya dalam teks. | 0,2 + 0,5 × proporsi kata kueri dalam judul; 0,2 jika hanya dalam teks |
fulltext | Tidak ada judul atau nama lain yang cocok, sehingga teks artikel ditelusuri (BM25): deskripsi dapat menemukan artikel yang namanya tidak Anda ketahui. | setidaknya 0,2 |
none | Tidak ada yang cocok. Respons kosong. | 0 |
Tingkat keyakinan ditentukan dengan aturan tetap, bukan probabilitas yang dikalibrasi; respons yang hasil terbaiknya memiliki skor di bawah 0,2 akan dikembalikan dalam keadaan kosong. Setiap hasil memuat highlight, yaitu kalimat dalam ringkasannya yang memuat kata kueri terbanyak. Pencarian yang tidak menemukan apa pun dicoba sekali lagi dengan huruf Latin (aksara Kiril, Yunani, kana, dan Hangul ditransliterasi, angka nada pinyin dihilangkan, vokal ganda romaji dipendekkan), dan respons menyebutkannya sebagai searched_as. Aksara Tionghoa tidak ditransliterasi.
| Opsi | Fungsi |
|---|---|
first=true | Hanya hasil terbaik, atau tidak ada hasil. |
topic={id}, geo={id} | Hanya artikel di bawah topik atau simpul geografi tersebut; geo menyaring semua hasil yang cocok hingga 1.000, dan scope menyatakan sejauh mana cakupan responsnya. |
sort=central | Subjek yang paling banyak ditautkan ditempatkan pertama, dari semua hasil yang cocok hingga 1.000. |
max_grade={grade} | Hanya artikel pada atau di bawah jenjang keterbacaan tersebut. |
facets=1 | Jumlah hasil yang cocok menurut topik tingkat teratas dan wilayah geografi, dari semua hasil yang cocok hingga 1.000 (facets.counted). |
Setiap respons
fields=a,b hanya mempertahankan kunci-kunci tersebut pada setiap hasil (atau pada respons, jika tidak memiliki hasil); struktur pembungkusnya (total, page, next, license) tetap dipertahankan. Respons 200 yang dapat disimpan dalam cache memuat ETag: kirimkan kembali sebagai If-None-Match, dan respons yang tidak berubah akan berupa 304 tanpa isi. Last-Modified adalah tanggal rilis korpus dan hanya bersifat informatif. Edgepedia-Corpus-Version menyebutkan rilis korpus, dan Content-Digest adalah SHA-256 isi respons (RFC 9530); .md suatu artikel juga memuat keduanya.
Rute lainnya
| Rute | Hasil |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | Semua artikel General, ditelusuri dalam urutan tetap: {id, slug, title, api_url} dan next (null di akhir). after= yang kosong memulai penelusuran dari awal, dan penelusuran dapat dilanjutkan setelah ID mana pun, bahkan yang telah dihapus. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | Pohon topik dan pohon geografi secara utuh: nodes: [[id, label, parent index, own articles]]; ID yang diawali titik melanjutkan ID induknya. |
/api/v1/releases | Rilis korpus, dari yang terbaru, dan current. |
/api/v1/health | application/health+json: pass, warn, atau fail (503). |
/api/v1/manifest | Pengalihan ke satu berkas JSONL terkompresi gzip, satu baris per artikel: { id, slug, title, updated, sha256, topic } (sha256 dari .md artikel). Ambil sekali untuk membuat salinan cermin Edgepedia. Nilai checksum dihitung dari teks yang dipublikasikan, sebelum koreksi dari pembaca: artikel yang berubah sejak rilis karena koreksi berdasarkan laporan pembaca tidak akan cocok dengan nilai itu hingga rilis berikutnya. |
/api/v1/changes?since={release} | Berkas-berkas perubahan dari rilis tersebut hingga rilis saat ini, secara berurutan (umpan dimulai pada 1.5: since=1.5 adalah yang paling awal); setiap baris berupa { op, id, … }, dengan op berupa salah satu dari added, changed, moved (from_slug adalah alamat lama), atau removed. |
/api/v1/events/{slug} | Kalimat-kalimat dalam artikel yang menyebutkan tanggal: { date, precision, text, para }, date sebagai YYYY, YYYY-MM, atau YYYY-MM-DD (negatif untuk sebelum Masehi: -0044-03-15). Tanggal sebelum Masehi mengikuti konvensi sejarah, bukan penomoran tahun astronomis: -0044 adalah 44 SM (pengurai ISO 8601 standar akan membacanya sebagai 45 SM). Kalimat itulah buktinya: bacalah sebelum memperlakukan tanggal tersebut sebagai fakta. |
/api/v1/aliases/{id} | Nama-nama lain suatu artikel, termasuk akronim yang disebutkan dalam artikel ("NASA"); salah eja dan variasi huruf besar-kecil tidak disertakan, dan jika ada dua ejaan untuk satu nama, yang dipertahankan adalah yang tanpa titik ("WHO", bukan "W.H.O."). |
Resolusi, anotasi, dan rekonsiliasi
Masukkan teks bebas, dapatkan ID artikel, tanpa model dan tanpa embedding. Teks yang dikirim untuk anotasi, klasifikasi, dan penguraian geografi tidak pernah dicatat dalam log atau disimpan.
| Rute | Hasil |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | Artikel yang paling mungkin dimaksud oleh suatu nama: result, confidence, ambiguous, match (exact, alias, anchor, partial, atau none), dan alternatives. type= hanya mempertahankan kandidat di bawah satu ID topik (jika tak satu pun dari 30 hasil pertama untuk nama itu berada di sana, pencarian untuk satu nama akan memeriksa 60 hasil berikutnya); limit= bernilai 1 hingga 10. POST menerima hingga 50: { "names": ["Paris", "Koala"] } atau { "queries": [{ "name": "Mercury", "context": "planet" }] }. Nama tanpa informasi tambahan yang belum dapat menentukan satu artikel memberikan respons ambiguous: true dengan tebakan terbaik sebagai result; kirim context untuk menentukan pilihan. |
/api/v1/surface?form=mercury | Semua artikel yang dituju oleh tautan dalam korpus itu sendiri untuk frasa yang persis sama ini, beserta jumlah tautan dan proporsi masing-masing (commonness). |
/api/v1/suggest?prefix=koa | Artikel yang judulnya persis cocok ditempatkan pertama, lalu artikel yang salah satu nama lainnya persis cocok, lalu judul yang dimulai dengan awalan tersebut, lalu nama lain yang dimulai dengan awalan itu (matched memberikan nama tersebut), untuk kotak pencarian dan antarmuka suara. |
POST /api/v1/annotate | { "text": "…" } (maksimal 20.000 karakter): setiap frasa bertaut beserta posisi awal dan akhirnya (start, end, dalam satuan kode UTF-16, seperti cara JavaScript mengindeks string: dalam Python, karakter di luar Basic Multilingual Plane, seperti emoji, dihitung dua), artikel, dan tingkat keyakinan. ?format=html juga mengembalikan teks yang telah di-escape untuk HTML, dengan setiap frasa diberi tautan. |
POST /api/v1/classify | { "text": "…" }: topik-topik yang dibahas teks, diberi skor berdasarkan jalur topik artikel yang disebutkannya, beserta proporsi topik tingkat teratasnya. |
POST /api/v1/geoparse | { "text": "…" }: tempat dan periode yang disebutkannya, pada pohon geografi (nodes, regions, places, periods); cabang nongeografis pohon tersebut (geo.nongeo) tidak pernah dianggap sebagai tempat. |
/api/v1/mentions?term=CRISPR | Artikel yang menyebut suatu subjek tanpa menautkan ke artikelnya; complete: false berarti daftar artikel yang menautkan telah dipotong. |
/api/v1/reconcile | Titik akhir Reconciliation Service API 0.2: manifes, queries batch (GET atau POST), saran entitas, tipe, dan properti, pratinjau, serta perluasan data (title, url, excerpt, topic, topic_path, importance_rank). JSONP dengan callback=. Di OpenRefine: Reconcile › Start reconciling › Add standard service, lalu tempelkan https://www.edgepedia.org/api/v1/reconcile. |
Graf tautan, tanggal, dan daftar
Diagram (format=mermaid) berupa teks Mermaid untuk aplikasi penampung yang merendernya.
| Rute | Hasil |
|---|---|
/api/v1/links/{slug} | Tautan artikel ke artikel lain, menurut urutan baca, masing-masing beserta teks jangkar dan kalimatnya. |
/api/v1/backlinks/{slug}?page= | Artikel-artikel yang menautkan ke artikel tersebut, 30 per halaman, dari yang paling penting, beserta teks jangkarnya. |
/api/v1/path?from=&to= | Rantai tautan terpendek antara dua artikel (maksimal 6 lompatan, sedapat mungkin menghindari simpul pusat), beserta kalimat yang membentuk setiap lompatan. Server MCP menyebutnya connect. |
/api/v1/compare?a=&b= | Dua artikel berdampingan: bagian pembuka, jalur topik, topik paling spesifik yang sama-sama menaungi keduanya, rantai di antara keduanya, tautan yang sama-sama dimiliki dan yang hanya dimiliki masing-masing, serta tabel Fakta utama masing-masing. |
/api/v1/graph/{slug}?depth=1|2&limit= | Hingga limit (nilai bawaan 50, maksimal 200) artikel tetangganya yang paling penting, beserta semua tautan di antaranya. complete: false (di sini, pada backlinks, dan pada rank/top) berarti batas waktu rute, sekitar satu detik, telah memotong respons; respons semacam itu hanya disimpan dalam cache selama satu menit. |
POST /api/v1/context | { "ids": [...] }, hingga 50 ID atau alamat (yang juga diterima oleh /rank?ids= dan /leads?ids=): tautan di antaranya, artikel yang bertaut dengan sebagian besar artikel tersebut, topik dan tempat paling spesifik yang sama-sama menaungi semuanya, serta bagian pembuka masing-masing. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | Tingkat kepentingan berdasarkan PageRank: jumlah pr di seluruh korpus adalah 1, peringkat 1 adalah yang paling sentral. Perhatikan penamaannya: importance pada /search dan artikel adalah peringkat ini dalam bentuk persentil 0 hingga 1; importance pada /resolve adalah nilai mentah pr, dan pada /leads adalah { pr, rank }. |
/api/v1/timeline?topic=|geo=&from=&to= | Kalimat bertanggal dari artikel-artikel suatu topik atau tempat, dari yang paling lama, 50 per halaman; tahun bernilai negatif untuk sebelum Masehi. Satu simpul menyimpan maksimal 200 peristiwa yang tersebar di sepanjang rentang tanggalnya, dan from serta to menyaring sampel itu; respons yang diambil dari sampel yang telah mencapai batas menyertakan sampled: true dan cap-nya, dan total menghitung jumlah dalam sampel tersebut. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | Peristiwa pada suatu tanggal dalam setahun (nilai bawaan adalah hari ini dalam UTC), atau dalam satu tahun (-9999 hingga 2100). Satu tanggal memuat maksimal 500 peristiwa dan satu tahun 2.000; yang telah mencapai batas menyertakan sampled: true. |
/api/v1/featured?date=, /api/v1/featured.xml | Artikel pilihan hari ini (Fakta hari ini pada halaman utama), dan umpan Atom untuk sepuluh hari terakhir. |
/api/v1/list?topic=|geo=&period=&type=person | Artikel dalam suatu topik, atau suatu tempat dan periode (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), 30 per halaman; type=person hanya mempertahankan artikel tentang orang. Baris-baris daftar geografi memuat geo dan tidak memuat id (ambil artikel untuk mendapatkannya). |
/api/v1/keyterms?topic=|geo=&limit= | Judul dan nama lain untuk suatu subpohon, sebagai bekal awal bagi pengenal ucapan. |
/api/v1/stats?topic=|geo=&by=period | Jumlah saja: artikel, tautan, dan nama lain untuk korpus atau suatu simpul beserta anak-anaknya. Di sini articles menghitung artikel yang berbeda; pada /geo dan /trees/geo, yang dihitung adalah penempatan, sehingga artikel dalam dua periode di suatu wilayah dihitung dua kali di sana. |
Penemuan dan protokol lainnya
- Kartu server MCP: /.well-known/mcp/server-card.json (juga
/mcp/server-card): nama, titik akhir, alat, dan versi, tanpa perlu terhubung. Konfigurasi registri:/.well-known/mcp/config-schema.jsondan/.well-known/mcp/examples.json. - Katalog AI: /.well-known/ai-catalog.json: semua cara mengakses (MCP, API ini, A2A, NLWeb, dan Agent Skill), beserta contoh kueri.
- Katalog API: /.well-known/api-catalog, kumpulan tautan RFC 9727 yang mencantumkan API ini, deskripsinya, dan dokumentasi ini.
- Agent Skill: /.well-known/agent-skills/index.json mencantumkan
SKILL.mdbeserta nilai hash sha256-nya. - OpenSearch: /opensearch.xml menambahkan Edgepedia sebagai penyedia pencarian.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessagedan 0.3message/send; kartu di/.well-known/agent-card.json). Nama subjek mengembalikan lima artikel teratas; alamat artikel mengembalikan artikel tersebut dalam Markdown beserta baris atribusinya. Respons selalu berupa pesan, bukan tugas, dan metode yang sama juga dilayani di/mcp. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET, atau POST dengan isi berupa JSON atau formulir) memberikan respons dalam struktur daftar NLWeb, dengan satuschema_objectschema.org untuk setiap hasil;streaming=truemengirimkan daftar itu sebagai peristiwa yang dikirim server. Tidak ada model yang dipanggil. - Format artikel untuk mesin: alamat artikel mengembalikan format yang disebutkan dalam header
Accept:text/markdown(dengan perkiraanx-markdown-tokens),application/json(respons API ini), atauapplication/ld+json; selain itu, yang dikembalikan adalah halaman artikel. Halaman artikel memuat headerLinkyang mencantumkan format-format ini, lisensi, katalog API, dan deskripsi OpenAPI.
Berkas yang dihasilkan
Dibuat dari /openapi.json, sehingga selalu selaras dengannya.
| Berkas | Isi |
|---|---|
| /openapi-3.0.json | Deskripsi yang sama dalam OpenAPI 3.0.3, untuk alat yang tidak dapat membaca 3.1. |
| /arazzo.json | Alur kerja Arazzo 1.0: mencari, mengambil hasil yang paling cocok, lalu artikel-artikel terkaitnya. |
| /tools.json | Setiap rute JSON sebagai fungsi yang dapat dipanggil model, dalam format OpenAI, Anthropic, dan Gemini, serta sebagai JSON Schema beserta rutenya. |
| /edgepedia.d.ts | Tipe TypeScript untuk setiap respons dan parameter setiap rute. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Satu contoh permintaan per rute untuk Postman, Bruno, Insomnia, dan VS Code atau JetBrains. |
Harap kirimkan User-Agent yang menyebutkan nama program Anda, seperti pada koleksi-koleksi tersebut (edgepedia-collection/1).