edgepedia

Edgepedia

API Edgepedia

Hơn 500.000 bài viết bách khoa và không ngừng tăng thêm, dưới dạng JSON. Miễn phí. Không cần khóa, không cần đăng ký. Được dùng cho mục đích thương mại khi ghi nguồn. Ai cũng có thể dùng để huấn luyện AI.

Dùng thử

Các tuyến đọc dữ liệu dùng GET; các tuyến di chuyển dữ liệu, xử lý theo lô và xử lý văn bản bạn gửi lên dùng POST. Mọi tuyến đều trả về JSON cho bất kỳ chương trình hay trang web nào (CORS cho phép mọi nguồn). Bản mô tả máy đọc được: /openapi.json, kèm một phản hồi mẫu cho mỗi tuyến; các bản tương đương dưới dạng OpenAPI 3.0, định nghĩa hàm cho mô hình, kiểu TypeScript và bộ sưu tập yêu cầu được liệt kê ở mục Các tệp được tạo tự động bên dưới.

Thẻ tham khảo

Giao diện

Đã chọn: Cantor's diagonal argument

Xem trước

Tiêu đề, toàn bộ phần tóm tắt của bài viết và dòng ghi nguồn Edgepedia, gói trong một thẻ để đặt trên trang web của bạn.

/embed/{id}?theme=auto cung cấp thẻ theo ID chính tắc của bài viết. Giao diện có thể là auto, light hoặc dark. Tập lệnh /assets/edgepedia-embed.js tùy chọn giúp khung tự khớp với nội dung; nếu không dùng, khung vẫn đọc và cuộn được.

/embed/{slug} cũng dùng được: nó chuyển hướng đến thẻ tại ID của bài viết và giữ nguyên giao diện. Edgepedia cũng là nhà cung cấp oEmbed: GET /oembed?url={article or card URL}&format=json trả về cùng mã nhúng như công cụ tạo thẻ ở trên dưới dạng html, kèm tiêu đề, chiều rộng và chiều cao; maxwidth và maxheight đều được áp dụng. Mỗi trang bài viết thuộc General đều liên kết đến địa chỉ oEmbed của mình trong <head>, nhờ đó WordPress, Discourse và các hệ thống tiếp nhận oEmbed khác có thể biến liên kết Edgepedia được dán vào thành thẻ.

Các tuyến

TuyếnKết quả trả về
/api/v1/search?q=wordsĐối sánh tiêu đề và các tên gọi khác, xếp kết quả phù hợp nhất lên đầu. Hãy tìm bằng tên của đối tượng, không phải bằng câu hỏi. Mỗi kết quả gồm: id, tiêu đề, chủ đề cấp cao nhất, văn bản xem trước, các liên kết và cách đối sánh (match, confidence). Những từ chỉ một chủ đề, chẳng hạn “science fiction writers”, còn trả về topics, một liên kết đến các bài viết thuộc chủ đề đó. limit là số kết quả mỗi trang, từ 1 đến 30 (mặc định là 10); page dùng để chuyển trang, và trang vượt quá trang cuối sẽ trống. Các tên gọi khác và tên viết sai cũng dùng được: “zhu yuanzhang” tìm thấy Hồng Vũ Đế, còn “siddartha” trả về did_you_mean. Các tùy chọn khác: xem mục Tìm kiếm bên dưới.
/api/v1/articles/{slug}Bài viết dưới dạng Markdown, đường dẫn chủ đề, các vị trí của bài trên cây địa lý (geo), ngày cập nhật gần nhất và dòng ghi nguồn cần hiển thị. Có thể dùng bất kỳ tên nào (Mount_Fuji, tiêu đề, địa chỉ đầy đủ); các tùy chọn cho phép trả về một mục, dàn ý, các đoạn trích hoặc những dạng khác: xem mục Đọc bài viết bên dưới.
/api/v1/articles?id={id}Như trên, nhưng tra theo id. ID bài viết cũ vẫn phân giải được sau khi di chuyển kho ngữ liệu; ID chủ đề có thể thay đổi khi cây được chỉnh sửa. Địa chỉ có thể chuyển đi; địa chỉ cũ vẫn trả lời, kèm moved_from. ids= nhận tối đa 10 mục cùng lúc.
/api/v1/leads?ids={id},{id}Tối đa 50 bài viết theo id, mỗi bài ở dạng một kết quả tìm kiếm (id, tiêu đề, chủ đề cấp cao nhất, văn bản xem trước, các liên kết), dành cho một trang thẻ. Với các ID đã di chuyển hoặc hợp nhất, kết quả trả về là bài viết được giữ lại, dùng ID đã yêu cầu làm khóa; id của kết quả là ID chính tắc. Các ID không xác định hoặc không khả dụng sẽ bị bỏ qua.
/api/v1/randomMột bài viết ngẫu nhiên. new=1 chọn trong số các bài viết mới nhất; topic= hoặc geo= chọn trong phạm vi một nút.
/api/v1/related/{slug}Các bài viết lân cận của một bài viết trong một lần gọi: tối đa 10 bài gần nhất trong cùng chủ đề, 3 bài từ mỗi chủ đề trong tối đa 8 chủ đề lân cận, và tối đa 10 bài gần nhất trong mỗi nút địa lý mà bài viết đó thuộc về. Ngoài ra còn có ?id={id}. Nếu dùng by=links thì trả về các bài viết được trích dẫn cùng bài đó.
/api/v1/topicsGốc cây chủ đề.
/api/v1/topics/{id}Đường dẫn của một chủ đề, các chủ đề con kèm số bài viết và mọi bài viết thuộc chủ đề đó, mỗi trang 30 bài. format=mermaid vẽ cây con của chủ đề.
/api/v1/geoCây địa lý: các vùng, mỗi vùng kèm các thời kỳ.
/api/v1/geo/{id}Một nút địa lý, có cấu trúc như một chủ đề: đường dẫn, các nút hẹp hơn và bài viết, mỗi trang 30 bài. Với một vùng thì chỉ liệt kê các thời kỳ của vùng đó.
POST /api/v1/ids/translateKhi bật chức năng di chuyển dữ liệu v1.5: gửi {"ids":["old-id", "another-id"]} (tối đa 500 ID khác nhau). Phản hồi ánh xạ các ID đã di chuyển sang ID chính tắc được giữ lại; các ID không đổi hoặc không xác định sẽ bị bỏ qua. Lưu mốc tiến độ sau mỗi lô hoàn tất và tuân thủ Retry-After.

Văn bản xem trước dùng đoạn trích trong kho ngữ liệu nếu có; nếu không thì dùng phần mở đầu bài viết. Bản ghi và kết quả có đoạn trích cũng chứa đoạn đó trong snippet; markdown vẫn là toàn văn bài viết. node, nếu có, là nút hiện tại của bài viết trên cây khái niệm.

Mỗi bài viết cũng có bản Markdown tại địa chỉ riêng. Thêm .md: www.edgepedia.org/koala.md.

Máy chủ MCP

https://www.edgepedia.org/mcp. Thêm vào Claude dưới dạng trình kết nối tùy chỉnh, vào ChatGPT khi đã bật chế độ Nhà phát triển, vào VS Code hoặc Cursor chỉ bằng một cú nhấp, hoặc vào bất kỳ trình khách MCP nào khác bằng địa chỉ của máy chủ. Không cần khóa, không cần đăng nhập. Có năm công cụ chỉ đọc: search (nhận tên đối tượng, trả về các bài viết phù hợp, cùng một chủ đề nếu các từ đó chỉ một chủ đề), fetch (một bài viết dưới dạng Markdown, kèm dòng ghi nguồn, đường dẫn chủ đề và thông tin địa lý; dùng citations: false để nhận văn bản ngắn hơn khoảng một phần tư; ID topic: liệt kê chủ đề cha, các chủ đề hẹp hơn và các bài viết của chủ đề đó, 120 bài cho mỗi page; topic:root và topic:geo là gốc của cây chủ đề và cây địa lý), related (các bài viết lân cận trong cùng chủ đề, các chủ đề gần đó và theo địa lý; dùng by: "links" để lấy các bài được trích dẫn cùng bài đó), connect (from, to: chuỗi liên kết giữa hai bài viết, như kết quả từ /api/v1/path) và resolve (name, với context và type tùy chọn: bài viết mà một tên gọi nhiều khả năng chỉ đến nhất, như kết quả từ /api/v1/resolve). Khi không có tiêu đề nào khớp với một truy vấn search, các bài viết có nội dung khớp sẽ được xếp sau các kết quả khớp tiêu đề, đánh dấu match: fulltext, nằm trong giới hạn limit và được tính vào pages. Lỗi công cụ là văn bản để mô hình đọc (kèm các ID did_you_mean nếu ID được hỏi không thuộc bài viết nào); mã lỗi nằm trong _meta["ai.edgechat/error"], không bao giờ nằm trong structuredContent. fetch với links: "in" nhận links_page để lấy 30 bài viết tiếp theo có liên kết đến đó.

search nhận limit (1 đến 30, mặc định là 10), page, first, topic và sort, đồng thời trả về page và pages; fetch nhận các tùy chọn bài viết bên dưới và ids để lấy nhiều bài cùng lúc. Mỗi kết quả đều kèm canonical_id, ID cố định của bài viết: fetch nhận ID này, và khi ID hoặc địa chỉ bạn đã lưu chuyển đi, fetch trả về bài viết với moved_from được đặt thành giá trị bạn đã yêu cầu. Kết quả ghi bản phát hành kho ngữ liệu trong _meta.corpus_version. Trình khách dùng giao thức 2025-06-18 trở lên còn nhận được một resource_link cho mỗi bài viết.

Tài nguyên: edgepedia://article/{slug} (bài viết dưới dạng Markdown, cùng nội dung với fetch) và edgepedia://topic/{id} (các chủ đề hẹp hơn và bài viết của một chủ đề), cả hai đều hỗ trợ tự động hoàn thành; chức năng này cũng gợi ý tiêu đề bài viết cho mọi đối số dùng để chỉ một bài viết. Agent Skill cũng được cung cấp qua MCP (skills/list, skills/get), dưới dạng skill://edgepedia/SKILL.md. Một yêu cầu GET tới /mcp trả về thẻ máy chủ dưới dạng JSON. Trình khách chỉ chấp nhận text/event-stream sẽ nhận mỗi phản hồi dưới dạng một sự kiện SSE message. Giá trị sha256 của danh sách công cụ được gửi kèm trong _meta (ai.edgechat/tools-sha256) của mỗi phản hồi, nhờ đó có thể nhận biết khi mô tả công cụ thay đổi.

Windows (bản xem trước, bản dựng 26220.7262 trở lên): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Các dòng lệnh thiết lập cho mọi trình khách khác, một Agent Skill và các ví dụ: github.com/EdgePlat/edgepedia-mcp.

Không có MCP, hoặc trình khách chỉ hỗ trợ cơ chế truyền tải SSE cũ? Hãy cấp cho mô hình hai hàm gọi /api/v1/search và /api/v1/articles/{slug}, hoặc lấy các hàm làm sẵn từ /tools.json. Các địa chỉ dùng cơ chế truyền tải cũ (/sse, /mcp/sse) trả về 404 với nội dung chỉ đến https://www.edgepedia.org/mcp.

Giới hạn

600 yêu cầu mỗi phút và 100.000 yêu cầu mỗi ngày cho mỗi địa chỉ IP, áp dụng như nhau cho API và máy chủ MCP. Mỗi phản hồi đều ghi cả hai khung thời gian trong RateLimit-Policy. Khi vượt giới hạn, API trả về 429 kèm Retry-After và RateLimit; lời gọi công cụ MCP trả về lỗi công cụ với số giây được ghi trong retry_after. Bộ đếm được duy trì riêng trên từng phiên bản máy chủ đang chạy, vì vậy đây là mức trần cần tránh vượt qua, không phải đồng hồ đo chính xác. Vui lòng dùng bộ nhớ đệm. Việc chuyển đổi ID cũ tính riêng từng ID được yêu cầu; các lô /leads dùng để dò ID cũ cũng được tính theo từng ID cũ. Với các lô khác, mỗi ID hoặc tên được tính là một yêu cầu; còn thao tác chú giải được tính một yêu cầu cho mỗi 1.000 ký tự.

Giấy phép

Giấy phép Cộng đồng Edgepedia 1.0: miễn phí khi ghi nguồn, kể cả sử dụng cho mục đích thương mại. Ai cũng có thể dùng để huấn luyện AI, và đầu ra của mô hình không cần ghi nguồn. Với các mục đích sử dụng khác, tổ chức có doanh thu trên 100 triệu USD hoặc trên 100 triệu người dùng hằng tháng phải có giấy phép riêng.

Ghi nguồn: hiển thị dòng credit của từng bài viết, kèm liên kết, ở bất cứ đâu bạn hiển thị nội dung bài đó. Phản hồi bài viết còn chứa các bản ghi nguồn sẵn để dán trong credit_md và credit_html, cùng license.spdx (LicenseRef-Edgepedia-Community-1.0). Phản hồi API cho bài viết và cho /leads có kèm Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" và X-License: LicenseRef-Edgepedia-Community-1.0.

Ứng dụng EdgeChat, các Edge Apps của ứng dụng và phần mềm của chúng tôi đều miễn phí nhưng là phần mềm độc quyền: không cung cấp mã nguồn, đồng thời không được sao chép, sửa đổi hay phân phối lại (Thỏa thuận Cấp phép EdgeChat).

Lỗi

JSON: { "error": { "code": "not_found", "message": "…" } }. 400 thiếu q, 404 không tìm thấy, 410 đã gỡ bỏ, 413 văn bản quá dài, 429 quá nhiều yêu cầu, 503 hãy thử lại. Phản hồi 404 chỉ rõ lời gọi tiếp theo: hint, next (một URL) và, với địa chỉ bài viết không trả về nội dung nào, did_you_mean chứa ba tiêu đề gần nhất. Lỗi không tìm thấy của công cụ MCP fetch cũng chứa did_you_mean như vậy.

Thay đổi

Phiên bản 1 giữ nguyên cấu trúc: có thể thêm trường, nhưng không bao giờ đổi tên hay xóa trường. Những thay đổi của chính Edgepedia được ghi tại /edgepedia/updates. Khi một bản phát hành tổ chức lại cây chủ đề, như bản 1.8.0 đã làm, ID chủ đề đã di chuyển sẽ trả về 301 kèm ID mới, và /api/v1/changes?since=<release> liệt kê mọi bài viết được thêm, sửa, di chuyển hoặc gỡ bỏ kể từ bản phát hành đó.

/api/v1 cung cấp corpus_version, corpus_updated và release_notes. Các giá trị này xác định bản phát hành đã công bố của kho ngữ liệu General và ngày phát hành, không phải ngày chỉnh sửa gần nhất của từng bài viết. Siêu dữ liệu tương tự cũng xuất hiện trong phần chỉ dẫn của máy chủ MCP. Các bản phát hành kho ngữ liệu không làm thay đổi phiên bản phần mềm API hay MCP. id_policy tại đó nêu rõ những gì một ID bảo đảm: một bản phát hành có thể đánh số lại hoặc hợp nhất các ID, như bản 1.5 đã làm, và các ID cũ vẫn tiếp tục trả lời thông qua mã 308 và POST /api/v1/ids/translate.

Có gì không hoạt động? Báo lỗi.

Tham chiếu

Các tuyến và trường đọc dữ liệu phái sinh (độ quan trọng, cấp độ đọc, liên kết, ngày tháng, các tên gọi khác và chỉ mục toàn văn) sẽ trả về 503 kèm Retry-After, hoặc bỏ trường đó, cho đến khi dữ liệu ấy được công bố cùng kho lưu trữ.

Đọc bài viết

/api/v1/articles/{slug} và MCP fetch nhận các tùy chọn sau; nếu không dùng tùy chọn, phản hồi sẽ là toàn bộ bài viết.

Tùy chọnKết quả trả về
section={heading}Một mục, tìm theo đề mục hoặc một từ trong đề mục đó (section=etymology tìm “Name and etymology”; section=lead là phần mở đầu), kèm các mục con. Đề mục không xác định sẽ trả về 404 kèm sections của bài viết.
outline=1outline: mọi đề mục kèm độ dài tính bằng token.
max_tokens={n}Văn bản được cắt ở ranh giới mục hoặc đoạn sao cho dài khoảng n token, kèm tokens_estimate, truncated và next_cursor; truyền giá trị đó vào cursor cùng với max_tokens như cũ để lấy phần còn lại.
length=snippet, length=leadĐoạn trích, hoặc tiêu đề và đoạn mở đầu, thay cho toàn văn.
format=text, html, jsonld, turtle, tablesPhản hồi dưới dạng văn bản thuần, phần nội dung đã kết xuất, hoặc các trường công khai dưới dạng JSON-LD hay Turtle; tables cung cấp từng bảng dưới dạng columns và rows, dưới dạng csv, đồng thời chuyển các trích dẫn của bảng vào cites và sources.
chunks=1chunks: bài viết chia thành các đoạn, mỗi đoạn có một ID ổn định được tạo từ đường dẫn đề mục (geology-2) và một cite_url.
q={words}&k={1–10}passages: k đoạn văn (mặc định là 3) khớp nhất với các từ đã cho, mỗi đoạn kèm một cite_url.
quote={sentence or chunk id}cite_url: địa chỉ bài viết kèm đoạn neo văn bản để mở trang ngay tại đoạn trích đó; quote_found cho biết bài viết có chứa đoạn ấy hay không.
cite={format}cite: thông tin tham chiếu đến bài viết, như kết quả từ /api/v1/cite.

Mỗi phản hồi bài viết cũng có speakable (đoạn trích ở dạng trợ lý giọng nói có thể đọc lên). importance và rank (PageRank trên các liên kết giữa bài viết; 1 là vị trí trung tâm nhất; đây là phép đếm liên kết, không phải đánh giá về đối tượng), words, reading_grade (Flesch-Kincaid) và reading_minutes chỉ có khi được nêu trong fields= (?fields=title,importance,rank); MCP fetch luôn có các trường này. next=1 bổ sung tối đa 5 bài viết để đọc tiếp. citations=false thay các liên kết nguồn ngay trong văn bản bằng ký hiệu [n], trong markdown, chunks và passages, giống như citations: false của MCP. Một địa chỉ không thuộc bài viết nào sẽ được hiểu là id bài viết (/api/v1/articles/ep7rbwcy0a) hoặc tiêu đề bài viết, không phân biệt chữ hoa, chữ thường và dấu (/api/v1/articles/paris); địa chỉ viết thường có dấu gạch nối mà không khớp theo các cách trên sẽ trả về 404, trừ khi bạn thêm ?suggest=1, còn địa chỉ có chữ hoa, dấu cách hoặc dấu gạch dưới (/api/v1/articles/Albert_Einstein) được hiểu là tên gọi, nên nếu chỉ gần khớp thì sẽ trả về kết quả tìm kiếm phù hợp nhất cùng resolved_by: search. Khi tên bạn đưa ra không phải địa chỉ của bài viết, phản hồi cho biết tên đó đã được hiểu theo cách nào (resolved_from, resolved_by: địa chỉ, tiêu đề hoặc tìm kiếm) và liệt kê 3 bài viết khác trong nearest. /api/v1/articles?ids={slug or id},{name} trả về tối đa 10 bài trong articles (mỗi bài kèm tên đã dùng để tra trong asked) và missing; mọi tùy chọn đều áp dụng cho từng bài.

Trích dẫn bài viết

/api/v1/cite/{slug}?format= cung cấp thông tin tham chiếu ở dạng csl (CSL-JSON, mặc định), bibtex, ris, apa, mla, chicago hoặc harvard, kèm dòng ghi nguồn dưới dạng văn bản, Markdown và HTML; /api/v1/cite?ids={id},{slug} làm tương tự cho tối đa 50 bài. Tác giả là Edgepedia (EdgeChat); APA, MLA, Chicago và Harvard đánh dấu tiêu đề in nghiêng bằng dấu sao, giống Markdown. Thẻ tham khảo cũng chứa cùng thông tin trích dẫn đó ở dạng ẩn, dưới dạng COinS và JSON-LD, để phần mềm quản lý tài liệu tham khảo sử dụng.

Tìm kiếm

matchKhi nàoconfidence
exactTiêu đề trùng với truy vấn.1,0 cho kết quả đầu tiên thuộc loại này, 0,9 cho kết quả sau
aliasKhớp với một tên gọi khác hoặc các chữ cái đầu của tiêu đề ("mlk").0,8; 0,7 nếu kết quả đầu tiên không chứa từ nào trong truy vấn; 0,6 nếu truy vấn được chuyển tự
misspellingCông cụ tìm kiếm đã sửa truy vấn (did_you_mean).0,5 × tỷ lệ phần truy vấn đã nhập được giữ lại sau khi sửa
partialMột số từ trong truy vấn có trong tiêu đề, hoặc chỉ có trong nội dung.0,2 + 0,5 × tỷ lệ từ trong truy vấn có trong tiêu đề; 0,2 nếu chỉ có trong nội dung
fulltextKhông có tiêu đề hay tên gọi khác nào khớp, nên tìm trong nội dung các bài viết (BM25): một mô tả sẽ giúp tìm bài viết mà bạn chưa biết tên.ít nhất 0,2
noneKhông có kết quả khớp. Phản hồi trống.0

Độ tin cậy được tính theo quy tắc cố định, không phải xác suất đã hiệu chỉnh; nếu kết quả tốt nhất có điểm dưới 0,2 thì phản hồi trả về sẽ trống. Mỗi kết quả có highlight, là câu trong phần tóm tắt chứa nhiều từ trong truy vấn nhất. Nếu không tìm thấy gì, truy vấn được thử lại một lần bằng chữ Latinh (chuyển tự chữ Kirin, chữ Hy Lạp, kana và Hangul, bỏ số chỉ thanh điệu trong bính âm, rút gọn nguyên âm viết đôi trong romaji), và phản hồi ghi truy vấn đó trong searched_as. Chữ Hán không được chuyển tự.

Tùy chọnTác dụng
first=trueChỉ kết quả phù hợp nhất, hoặc không có kết quả nào.
topic={id}, geo={id}Chỉ các bài viết thuộc chủ đề hoặc nút địa lý đó; geo lọc trên toàn bộ kết quả khớp, tối đa 1.000 kết quả, và scope cho biết phạm vi mà phản hồi bao quát.
sort=centralXếp các đối tượng được liên kết đến nhiều nhất lên đầu, trong toàn bộ kết quả khớp, tối đa 1.000 kết quả.
max_grade={grade}Chỉ các bài viết có cấp độ đọc bằng hoặc thấp hơn mức đó.
facets=1Số kết quả khớp theo chủ đề cấp cao nhất và theo vùng địa lý, tính trên toàn bộ kết quả khớp, tối đa 1.000 kết quả (facets.counted).

Mọi phản hồi

fields=a,b chỉ giữ lại các khóa được chỉ định của mỗi kết quả (hoặc của phản hồi, khi không có kết quả); phần bao ngoài (total, page, next, license) vẫn được giữ nguyên. Phản hồi 200 có thể lưu vào bộ nhớ đệm sẽ kèm ETag: gửi lại giá trị đó trong If-None-Match, và nếu phản hồi không đổi thì bạn sẽ nhận được 304 không có phần thân. Last-Modified là ngày phát hành kho ngữ liệu, chỉ để tham khảo. Edgepedia-Corpus-Version nêu bản phát hành kho ngữ liệu, còn Content-Digest là giá trị SHA-256 của phần thân (RFC 9530); bản .md của bài viết cũng có cả hai.

Các tuyến khác

TuyếnKết quả trả về
/api/v1/articles?after={id}&limit={1..1000}Mọi bài viết thuộc General, được duyệt theo thứ tự cố định: {id, slug, title, api_url} và next (null khi đến cuối). Để trống after= thì bắt đầu từ đầu; có thể tiếp tục duyệt từ sau bất kỳ id nào, kể cả id đã bị gỡ bỏ.
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoToàn bộ cây chủ đề và cây địa lý: nodes: [[id, label, parent index, own articles]]; id bắt đầu bằng dấu chấm là phần nối tiếp id của nút cha.
/api/v1/releasesCác bản phát hành kho ngữ liệu, mới nhất trước, cùng current.
/api/v1/healthapplication/health+json: pass, warn hoặc fail (503).
/api/v1/manifestChuyển hướng đến một tệp JSONL nén gzip, mỗi dòng một bài viết: { id, slug, title, updated, sha256, topic } (sha256 của bản .md của bài viết). Tải một lần để tạo bản sao Edgepedia. Giá trị kiểm tra được tính từ văn bản đã công bố, trước những chỉnh sửa theo báo cáo của người đọc: bài viết đã thay đổi vì một chỉnh sửa như vậy kể từ lần phát hành sẽ không khớp giá trị này cho đến bản phát hành tiếp theo.
/api/v1/changes?since={release}Các tệp thay đổi từ bản phát hành đó đến bản hiện tại, theo thứ tự (luồng thay đổi bắt đầu từ 1.5: since=1.5 là bản sớm nhất); mỗi dòng là { op, id, … }, với op là một trong các giá trị added, changed, moved (from_slug là địa chỉ cũ) hoặc removed.
/api/v1/events/{slug}Những câu trong bài viết nêu ngày tháng: { date, precision, text, para }, date dưới dạng YYYY, YYYY-MM hoặc YYYY-MM-DD (số âm chỉ thời gian trước Công nguyên: -0044-03-15). Niên đại trước Công nguyên theo quy ước lịch sử, không theo cách đánh số năm thiên văn: -0044 là năm 44 trước Công nguyên (bộ phân tích ISO 8601 tiêu chuẩn sẽ hiểu là năm 45 trước Công nguyên). Câu văn là bằng chứng: hãy đọc câu đó trước khi coi ngày tháng ấy là sự thật.
/api/v1/aliases/{id}Các tên gọi khác của bài viết, gồm cả những từ viết tắt được nêu trong bài ("NASA"); bỏ qua cách viết sai và các biến thể chữ hoa, chữ thường; nếu một tên có hai cách viết thì giữ cách không có dấu chấm ("WHO", không phải "W.H.O.").

Phân giải, chú giải và đối soát

Đầu vào là văn bản tự do, đầu ra là id bài viết, không dùng mô hình hay phép nhúng. Văn bản gửi đến các chức năng chú giải, phân loại và phân tích địa lý không bao giờ được ghi nhật ký hay lưu giữ.

TuyếnKết quả trả về
/api/v1/resolve?name=Mercury&context=planetBài viết mà một tên gọi nhiều khả năng chỉ đến nhất: result, confidence, ambiguous, match (exact, alias, anchor, partial hoặc none) và alternatives. type= chỉ giữ các bài ứng viên thuộc một id chủ đề (nếu không bài nào trong 30 kết quả khớp đầu tiên của tên đó thuộc chủ đề này, truy vấn một tên riêng lẻ sẽ tìm tiếp trong 60 kết quả sau); limit= từ 1 đến 10. POST nhận tối đa 50 tên: { "names": ["Paris", "Koala"] } hoặc { "queries": [{ "name": "Mercury", "context": "planet" }] }. Nếu chỉ có tên mà chưa xác định được duy nhất một bài viết, phản hồi trả về ambiguous: true cùng phỏng đoán tốt nhất trong result; truyền context để chọn.
/api/v1/surface?form=mercuryMọi bài viết mà các liên kết trong chính kho ngữ liệu trỏ đến bằng đúng cụm từ này, kèm số liên kết và tỷ lệ của từng bài (commonness).
/api/v1/suggest?prefix=koaBài viết có tiêu đề trùng khớp hoàn toàn trước, rồi đến bài có một tên gọi khác trùng khớp hoàn toàn, tiếp theo là các tiêu đề bắt đầu bằng tiền tố đó, sau cùng là các tên gọi khác bắt đầu như vậy (matched cho biết tên gọi ấy), dành cho ô tìm kiếm và giao diện giọng nói.
POST /api/v1/annotate{ "text": "…" } (tối đa 20.000 ký tự): mỗi cụm từ được liên kết kèm các vị trí của nó (start, end, tính bằng đơn vị mã UTF-16, như cách JavaScript đánh chỉ số chuỗi: trong Python, một ký tự ngoài Mặt phẳng Đa ngữ Cơ bản, chẳng hạn emoji, được tính là hai), bài viết và độ tin cậy. ?format=html còn trả về văn bản đã chuyển các ký tự đặc biệt sang dạng thoát HTML, với từng cụm từ được gắn liên kết.
POST /api/v1/classify{ "text": "…" }: các chủ đề mà văn bản đề cập, được chấm điểm theo đường dẫn chủ đề của những bài viết được nhắc đến, cùng tỷ lệ ở cấp cao nhất.
POST /api/v1/geoparse{ "text": "…" }: các địa điểm và thời kỳ được nêu tên trong văn bản, trên cây địa lý (nodes, regions, places, periods); nhánh phi địa lý của cây (geo.nongeo) không bao giờ được coi là địa điểm.
/api/v1/mentions?term=CRISPRCác bài viết nhắc đến một đối tượng mà không liên kết đến bài viết về đối tượng đó; complete: false nghĩa là danh sách các bài viết có liên kết đến đã bị cắt ngắn.
/api/v1/reconcileMột điểm cuối API Dịch vụ Đối soát 0.2: bản kê khai, queries theo lô (GET hoặc POST), gợi ý thực thể, kiểu và thuộc tính, bản xem trước và phần mở rộng dữ liệu (title, url, excerpt, topic, topic_path, importance_rank). Hỗ trợ JSONP với callback=. Trong OpenRefine: Reconcile › Start reconciling › Add standard service, rồi dán https://www.edgepedia.org/api/v1/reconcile.

Đồ thị liên kết, ngày tháng và danh sách

Sơ đồ (format=mermaid) là văn bản Mermaid để hệ thống hiển thị hỗ trợ định dạng này kết xuất.

TuyếnKết quả trả về
/api/v1/links/{slug}Các liên kết từ bài viết đến những bài viết khác, theo thứ tự đọc, mỗi liên kết kèm văn bản neo và câu chứa nó.
/api/v1/backlinks/{slug}?page=Các bài viết liên kết đến bài này, mỗi trang 30 bài, bài quan trọng nhất trước, kèm văn bản neo.
/api/v1/path?from=&to=Chuỗi liên kết ngắn nhất giữa hai bài viết (tối đa 6 bước, tránh các nút trung tâm nếu có thể), kèm câu tạo nên từng bước liên kết. Máy chủ MCP gọi chức năng này là connect.
/api/v1/compare?a=&b=Hai bài viết đặt cạnh nhau: phần mở đầu, đường dẫn chủ đề, chủ đề chung sâu nhất, chuỗi liên kết giữa hai bài, các liên kết chung và riêng, cùng bảng Thông tin chính của từng bài.
/api/v1/graph/{slug}?depth=1|2&limit=Tối đa limit bài viết lân cận quan trọng nhất (mặc định 50, tối đa 200), cùng mọi liên kết giữa chúng. complete: false (ở đây, ở các liên kết ngược và ở rank/top) nghĩa là phản hồi bị cắt ngắn do hết thời gian xử lý khoảng một giây của tuyến; phản hồi như vậy chỉ được lưu trong bộ nhớ đệm một phút.
POST /api/v1/context{ "ids": [...] }, tối đa 50 id hoặc địa chỉ (/rank?ids= và /leads?ids= cũng nhận các giá trị này): các liên kết giữa chúng, những bài viết có liên kết với phần lớn các bài đó, chủ đề và địa điểm chung sâu nhất, cùng phần mở đầu của từng bài.
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=Độ quan trọng theo PageRank: tổng pr trên toàn kho ngữ liệu bằng 1, hạng 1 là vị trí trung tâm nhất. Lưu ý tên trường: importance trên /search và các bài viết là thứ hạng này biểu diễn bằng phân vị từ 0 đến 1; importance của /resolve là giá trị pr thô, còn của /leads là { pr, rank }.
/api/v1/timeline?topic=|geo=&from=&to=Các câu có ngày tháng từ những bài viết thuộc một chủ đề hoặc địa điểm, cũ nhất trước, mỗi trang 50 câu; năm âm chỉ thời gian trước Công nguyên. Mỗi nút giữ tối đa 200 sự kiện trải khắp các mốc thời gian của nó, và from cùng to lọc trên mẫu đó; phản hồi lấy từ một mẫu đã chạm giới hạn sẽ ghi sampled: true và cap của mẫu, còn total đếm số mục trong mẫu.
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}Các sự kiện vào một ngày trong năm (mặc định là hôm nay theo UTC), hoặc trong một năm (từ -9999 đến 2100). Mỗi ngày chứa tối đa 500 sự kiện, mỗi năm 2.000; nếu đã chạm giới hạn thì phản hồi ghi sampled: true.
/api/v1/featured?date=, /api/v1/featured.xmlBài viết nổi bật trong ngày (mục Thông tin hôm nay trên trang chủ) và nguồn cấp Atom của mười ngày gần nhất.
/api/v1/list?topic=|geo=&period=&type=personCác bài viết thuộc một chủ đề, hoặc một địa điểm và thời kỳ (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), mỗi trang 30 bài; type=person chỉ giữ các nhân vật. Các dòng trong danh sách địa lý có geo và không có id (hãy lấy bài viết để có trường này).
/api/v1/keyterms?topic=|geo=&limit=Tiêu đề và các tên gọi khác trong một cây con, để cung cấp trước cho bộ nhận dạng tiếng nói.
/api/v1/stats?topic=|geo=&by=periodChỉ số lượng: bài viết, liên kết và tên gọi khác trong kho ngữ liệu hoặc trong một nút cùng các nút con. Ở đây, articles đếm các bài viết riêng biệt; trên /geo và /trees/geo, trường này đếm số vị trí xếp bài, nên một bài viết thuộc hai thời kỳ của cùng một vùng sẽ được tính hai lần ở đó.

Khám phá và các giao thức khác

Các tệp được tạo tự động

Được tạo từ /openapi.json, nên luôn nhất quán với tệp đó.

TệpNội dung
/openapi-3.0.jsonCùng bản mô tả đó ở dạng OpenAPI 3.0.3, dành cho các công cụ không đọc được 3.1.
/arazzo.jsonMột quy trình Arazzo 1.0: tìm kiếm, lấy bài viết phù hợp nhất, rồi lấy các bài viết liên quan.
/tools.jsonMỗi tuyến JSON được biểu diễn thành một hàm mà mô hình có thể gọi, theo các định dạng OpenAI, Anthropic và Gemini, đồng thời ở dạng JSON Schema kèm tuyến tương ứng.
/edgepedia.d.tsCác kiểu TypeScript cho mọi phản hồi và các tham số của từng tuyến.
/edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.httpMỗi tuyến có một yêu cầu mẫu dành cho Postman, Bruno, Insomnia và VS Code hoặc JetBrains.

Vui lòng gửi một User-Agent nêu tên chương trình của bạn, như trong các bộ sưu tập yêu cầu mẫu (edgepedia-collection/1).