edgepedia

Edgepedia

API de Edgepedia

Más de 500.000 artículos enciclopédicos, y la cifra sigue creciendo, en JSON. Gratis. Sin clave ni registro. Uso comercial con atribución. Entrenamiento de IA abierto a todo el mundo.

Pruébala

Las rutas de lectura usan GET; la migración, los lotes y el texto que envíes usan POST. Todas las rutas responden con JSON a cualquier programa o página web (CORS permite todos los orígenes). Descripción legible por máquinas: /openapi.json, con una respuesta de ejemplo para cada ruta; la misma descripción en OpenAPI 3.0, las definiciones de funciones para modelos, los tipos de TypeScript y las colecciones de solicitudes figuran más abajo, en Archivos generados.

Tarjetas de referencia

Apariencia

Seleccionado: Cantor's diagonal argument

Vista previa

El título de un artículo, su resumen completo y la atribución a Edgepedia en una tarjeta para tu sitio web.

/embed/{id}?theme=auto sirve una tarjeta a partir del ID canónico del artículo. La apariencia puede ser auto, light o dark. El script opcional /assets/edgepedia-embed.js ajusta el marco a su contenido; sin él, el marco sigue siendo legible y permite desplazarse por su contenido.

/embed/{slug} también funciona: redirige a la tarjeta correspondiente al ID del artículo y conserva el tema visual. Edgepedia también es un proveedor de oEmbed: GET /oembed?url={article or card URL}&format=json devuelve el mismo código de inserción que el generador anterior como html, con el título, el ancho y la altura; se respetan maxwidth y maxheight. Todas las páginas de artículos de General enlazan su dirección de oEmbed en su <head>, de modo que WordPress, Discourse y otros consumidores de oEmbed convierten un enlace pegado de Edgepedia en una tarjeta.

Rutas

RutaDevuelve
/api/v1/search?q=wordsCoincidencias de títulos y otros nombres, con las mejores primero. Busca un nombre (de una persona, un lugar o un concepto), no una pregunta. Cada resultado incluye: id, título, tema de nivel superior, texto de vista previa, enlaces y cómo se produjo la coincidencia (match, confidence). Las palabras que designan un tema, como «escritores de ciencia ficción», también devuelven topics, un enlace a sus artículos. limit es el tamaño de página, de 1 a 30 (10 de forma predeterminada); page permite pasar de página, y una página posterior a la última está vacía. También funcionan otros nombres y las faltas de ortografía: «zhu yuanzhang» encuentra al emperador Hongwu, y «siddartha» devuelve did_you_mean. Más opciones: Búsqueda, más abajo.
/api/v1/articles/{slug}El artículo en Markdown, su ruta temática, sus ubicaciones en el árbol geográfico (geo), su fecha de última actualización y la línea de atribución que se debe mostrar. Funciona cualquier nombre (Mount_Fuji, un título, una dirección completa), y las opciones devuelven una sección, un esquema, pasajes u otros formatos: Lectura de un artículo, más abajo.
/api/v1/articles?id={id}Lo mismo, por id. Los ids antiguos de los artículos siguen resolviéndose después de una migración del corpus; los ids de los temas pueden cambiar cuando se revisa el árbol. Una dirección puede cambiar; la antigua sigue respondiendo, con moved_from. ids= acepta hasta 10 a la vez.
/api/v1/leads?ids={id},{id}Hasta 50 artículos por id, cada uno como un resultado de búsqueda (id, título, tema de nivel superior, texto de vista previa, enlaces), para una página de tarjetas. Los ids migrados y fusionados devuelven el artículo que se conserva, con el id solicitado como clave; el id del resultado es canónico. Se omiten los ids desconocidos o no disponibles.
/api/v1/randomUn artículo al azar. new=1 elige entre los artículos más recientes; topic= o geo= elige bajo un nodo.
/api/v1/related/{slug}Los artículos vecinos de un artículo en una sola llamada: hasta los 10 más cercanos dentro de su propio tema, 3 de cada uno de hasta 8 temas vecinos y hasta los 10 más cercanos en cada nodo geográfico al que pertenece. También ?id={id}. by=links ofrece, en cambio, los artículos que se citan junto con él.
/api/v1/topicsLa raíz del árbol temático.
/api/v1/topics/{id}La ruta de un tema, sus subtemas con el número de artículos y todos los artículos que contiene, a razón de 30 por página. format=mermaid dibuja su subárbol.
/api/v1/geoEl árbol geográfico: sus regiones, cada una con sus períodos.
/api/v1/geo/{id}Un nodo geográfico, con la misma estructura que un tema: su ruta, los nodos más específicos y los artículos, a razón de 30 por página. Una región solo enumera sus períodos.
POST /api/v1/ids/translateCon la migración de la versión 1.5 habilitada: envía {"ids":["old-id", "another-id"]} (hasta 500 ids distintos). La respuesta asocia los ids trasladados con los ids canónicos que los sustituyen; se omiten los ids que no han cambiado o son desconocidos. Guarda puntos de control de los lotes completados y respeta Retry-After.

El texto de vista previa usa el fragmento del corpus cuando está disponible y, en caso contrario, el inicio del artículo. Los registros y resultados que tienen un fragmento también lo incluyen como snippet; markdown sigue siendo el texto completo del artículo. node, cuando está presente, es el nodo actual del artículo en el árbol de conceptos.

Cada artículo también está disponible en Markdown en su propia dirección. Añade .md: www.edgepedia.org/koala.md.

Servidor MCP

https://www.edgepedia.org/mcp. Añádelo a Claude como conector personalizado, a ChatGPT con el modo de desarrollador activado, a VS Code o Cursor con un clic, o a cualquier otro cliente MCP mediante su dirección. Sin clave ni inicio de sesión. Cinco herramientas de solo lectura: search (recibe un nombre y devuelve los artículos que coinciden, además de un tema cuando las palabras designan uno), fetch (un artículo en Markdown, con su línea de atribución, su ruta temática y su información geográfica; citations: false para obtener un texto aproximadamente un cuarto más corto; un id de topic: enumera el tema superior de ese tema, sus temas más específicos y sus artículos, a razón de 120 por page; topic:root y topic:geo son las raíces de los árboles temático y geográfico), related (los artículos vecinos de un artículo en su tema, en temas cercanos y en su ámbito geográfico; by: "links" para los artículos que se citan junto con él), connect (from, to: la cadena de enlaces entre dos artículos, tal como la ofrece /api/v1/path) y resolve (name, con context y type opcionales: el artículo al que con mayor probabilidad se refiere un nombre, tal como lo ofrece /api/v1/resolve). Cuando ningún título coincide con una búsqueda de search, los artículos cuyo texto sí coincide aparecen después de las coincidencias de título, marcados como match: fulltext, dentro de limit y contabilizados en pages. Un error de herramienta es texto que lee el modelo (con ids de did_you_mean cuando el id no corresponde a ningún artículo); su código se transmite en _meta["ai.edgechat/error"], nunca en structuredContent. fetch con links: "in" acepta links_page para obtener los siguientes 30 artículos que enlazan a ese artículo.

search acepta limit (de 1 a 30, 10 de forma predeterminada), page, first, topic y sort, y devuelve page y pages; fetch acepta las opciones de artículo que se indican más abajo y ids para obtener varios a la vez. Cada resultado incluye canonical_id, el id permanente del artículo: fetch lo acepta y, cuando un id o una dirección que hayas guardado ha cambiado, fetch devuelve el artículo con moved_from establecido en el valor que solicitaste. Los resultados indican la versión del corpus en _meta.corpus_version. Los clientes que usan la versión 2025-06-18 del protocolo o una posterior también reciben un resource_link por artículo.

Recursos: edgepedia://article/{slug} (un artículo en Markdown, el mismo texto que fetch) y edgepedia://topic/{id} (los temas más específicos de un tema y sus artículos), con autocompletado para ambos; el autocompletado también sugiere títulos de artículos para cualquier argumento que designe un artículo. La habilidad para agentes también se sirve a través de MCP (skills/list, skills/get), como skill://edgepedia/SKILL.md. Un GET de /mcp devuelve la ficha del servidor en JSON. Los clientes que solo aceptan text/event-stream reciben cada respuesta como un único evento message de SSE. El sha256 de la lista de herramientas se transmite en el _meta de cada respuesta (ai.edgechat/tools-sha256), por lo que cualquier cambio en la descripción de una herramienta queda visible.

Windows (versión preliminar, compilación 26220.7262 o posterior): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Líneas de configuración para todos los demás clientes, una habilidad para agentes y ejemplos: github.com/EdgePlat/edgepedia-mcp.

¿No tienes MCP o tu cliente solo admite el antiguo transporte SSE? Proporciona a tu modelo dos funciones que llamen a /api/v1/search y /api/v1/articles/{slug}, o tómalas ya preparadas de /tools.json. Las direcciones del transporte antiguo (/sse, /mcp/sse) responden con 404 y un cuerpo que indica https://www.edgepedia.org/mcp.

Límites

600 solicitudes por minuto y 100.000 al día por dirección IP, tanto en la API como en el servidor MCP. Todas las respuestas indican ambos intervalos en RateLimit-Policy. Al superarlos, la API responde con 429, Retry-After y RateLimit; una llamada a una herramienta MCP devuelve un error de herramienta cuyo retry_after indica los segundos. Los recuentos se mantienen por instancia de servidor, por lo que son un límite que no se debe alcanzar, no un medidor exacto. Utiliza la caché. La traducción de ids (POST /api/v1/ids/translate) cuenta cada id solicitado por separado; los lotes de /leads que consultan ids antiguos también se contabilizan por cada id antiguo. Los demás lotes cuentan cada id o nombre como una solicitud, y la anotación cuenta una por cada 1.000 caracteres.

Licencia

Licencia comunitaria de Edgepedia 1.0: uso gratuito con atribución, incluido el uso comercial. El entrenamiento de IA está abierto a todo el mundo, y las respuestas de un modelo no requieren atribución. Para otros usos, las organizaciones con más de 100 millones de USD de ingresos o 100 millones de usuarios mensuales necesitan una licencia independiente.

Atribución: muestra la línea credit de cada artículo, con su enlace, dondequiera que muestres su texto. Las respuestas de artículos también la incluyen lista para pegar como credit_md y credit_html, además de license.spdx (LicenseRef-Edgepedia-Community-1.0). Las respuestas de la API de artículos y de /leads incluyen Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" y X-License: LicenseRef-Edgepedia-Community-1.0.

La aplicación EdgeChat, sus Edge Apps y nuestro software son gratuitos, pero de código propietario: no se proporciona el código fuente y no se permite copiarlos, modificarlos ni redistribuirlos (Acuerdo de licencia de EdgeChat).

Errores

JSON: { "error": { "code": "not_found", "message": "…" } }. 400 falta q, 404 no encontrado, 410 eliminado, 413 texto demasiado largo, 429 demasiadas solicitudes, 503 vuelve a intentarlo. Un error 404 indica la siguiente llamada: hint, next (una URL) y, para una dirección de artículo que no devuelve nada, did_you_mean con los tres títulos más cercanos. El error de «no encontrado» de la herramienta MCP fetch incluye el mismo did_you_mean.

Cambios

La versión 1 mantiene su estructura: se pueden añadir campos, pero nunca cambiarles el nombre ni eliminarlos. Los cambios de la propia Edgepedia están en /edgepedia/updates. Cuando una versión reorganiza el árbol temático, como ocurrió con la 1.8.0, el id de un tema que se haya trasladado responde con 301 y su nuevo id, y /api/v1/changes?since=<release> enumera todos los artículos añadidos, modificados, trasladados o eliminados desde esa versión.

/api/v1 informa de corpus_version, corpus_updated y release_notes. Estos identifican la versión publicada del corpus General y su fecha de publicación, no la fecha de la última edición de cada artículo. Los mismos metadatos aparecen en las instrucciones del servidor MCP. Las versiones del corpus no cambian la versión del software de la API ni de MCP. Allí, id_policy indica qué garantiza un id: una versión puede renumerar o fusionar ids, como hizo la 1.5, y los ids antiguos siguen respondiendo mediante un 308 y POST /api/v1/ids/translate.

¿Algo no funciona? Notifícalo.

Referencia

Las rutas y los campos que leen datos derivados (importancia, niveles de lectura, enlaces, fechas, otros nombres e índice de texto completo) responden con 503 y Retry-After, u omiten el campo, hasta que esos datos se publiquen junto con el almacén de datos.

Lectura de un artículo

/api/v1/articles/{slug} y la herramienta MCP fetch aceptan estas opciones; sin ellas, la respuesta es el artículo completo.

OpciónDevuelve
section={heading}Una sección, por su encabezado o una palabra de él (section=etymology encuentra «Nombre y etimología»; section=lead es el inicio), con sus subsecciones. Un encabezado desconocido devuelve 404 con el sections del artículo.
outline=1outline: todos los encabezados con su tamaño en tokens.
max_tokens={n}El texto recortado a unos n tokens en un límite de sección o de párrafo, con tokens_estimate, truncated y next_cursor; pásalo como cursor con el mismo max_tokens para obtener el resto.
length=snippet, length=leadEl fragmento, o el título y el párrafo inicial, en lugar del texto completo.
format=text, html, jsonld, turtle, tablesLa respuesta como texto sin formato, el cuerpo renderizado o sus campos públicos en JSON-LD o Turtle; tables ofrece cada tabla como columns y rows, como csv y con sus citas trasladadas a cites y sources.
chunks=1chunks: el artículo en párrafos, cada uno con un id estable basado en su ruta de encabezados (geology-2) y un cite_url.
q={words}&k={1–10}passages: los k párrafos (3 de forma predeterminada) que mejor coinciden con las palabras, cada uno con un cite_url.
quote={sentence or chunk id}cite_url: la dirección del artículo con un fragmento de texto que abre la página en ese pasaje; quote_found indica si el artículo lo contiene.
cite={format}cite: una referencia al artículo, tal como la ofrece /api/v1/cite.

Cada respuesta de artículo también incluye speakable (el fragmento tal como puede leerlo un asistente de voz). importance y rank (PageRank sobre los enlaces entre artículos; 1 es el más central; un recuento de enlaces, no una valoración del tema), words, reading_grade (Flesch-Kincaid) y reading_minutes solo aparecen cuando fields= los especifica (?fields=title,importance,rank); la herramienta MCP fetch siempre los incluye. next=1 añade hasta 5 artículos para seguir leyendo. citations=false ofrece marcadores [n] en lugar de los enlaces a las fuentes insertados en el texto, en markdown, chunks y passages, al igual que citations: false en MCP. Una dirección que no corresponde a ningún artículo se interpreta como un id de artículo (/api/v1/articles/ep7rbwcy0a) o como su título, sin distinguir mayúsculas ni acentos (/api/v1/articles/paris); una dirección en minúsculas y con guiones que se aparte más de esas formas devuelve 404, salvo que añadas ?suggest=1, mientras que una dirección con mayúsculas, espacios o guiones bajos (/api/v1/articles/Albert_Einstein) se interpreta como un nombre, de modo que una coincidencia aproximada devuelve el mejor resultado de búsqueda con resolved_by: search. Cuando el nombre que has dado no es la dirección del artículo, la respuesta indica cómo se interpretó (resolved_from, resolved_by: dirección, título o búsqueda) y enumera en nearest los otros 3 artículos más cercanos. /api/v1/articles?ids={slug or id},{name} devuelve hasta 10 como articles (cada uno con el nombre al que responde en asked) y missing; todas las opciones se aplican a cada uno.

Citar un artículo

/api/v1/cite/{slug}?format= ofrece una referencia en csl (CSL-JSON, de forma predeterminada), bibtex, ris, apa, mla, chicago o harvard, con la línea de atribución como texto, Markdown y HTML; /api/v1/cite?ids={id},{slug} hace lo mismo para un máximo de 50. El autor es Edgepedia (EdgeChat); APA, MLA, Chicago y Harvard marcan el título en cursiva con asteriscos, como hace Markdown. Las Tarjetas de referencia incluyen la misma cita de forma invisible, como COinS y JSON-LD, para los gestores bibliográficos.

Búsqueda

matchCuándoconfidence
exactEl título coincide con la consulta.1,0 para el primer resultado de este tipo, 0,9 para uno posterior
aliasCoincide otro nombre o las iniciales del título («mlk»).0,8; 0,7 para un primer resultado que no contiene ninguna palabra de la consulta; 0,6 para una consulta transliterada
misspellingLa búsqueda ha corregido la consulta (did_you_mean).0,5 × la proporción de la consulta escrita que conserva la corrección
partialAlgunas palabras de la consulta aparecen en el título, o solo en el texto.0,2 + 0,5 × la proporción de palabras de la consulta presentes en el título; 0,2 si solo aparecen en el texto
fulltextNo coincide ningún título ni otro nombre, por lo que se ha buscado en el texto de los artículos (BM25): una descripción permite encontrar el artículo cuyo nombre no conoces.al menos 0,2
noneNo hay coincidencias. La respuesta está vacía.0

La confianza se rige por una regla fija, no es una probabilidad calibrada; una respuesta cuyo mejor resultado tenga una puntuación inferior a 0,2 se devuelve vacía. Cada resultado incluye highlight, la oración de su resumen que contiene más palabras de la consulta. Una búsqueda que no encuentra nada se repite una vez en letras latinas (se transliteran el cirílico, el griego, los kana y el hangul, se eliminan los números de tono del pinyin y se acortan las vocales dobles del romaji), y la respuesta la indica como searched_as. Los caracteres chinos no se transliteran.

OpciónQué hace
first=trueSolo la mejor coincidencia, o ninguna.
topic={id}, geo={id}Solo artículos bajo ese tema o nodo geográfico; geo filtra todas las coincidencias hasta un máximo de 1.000, y scope indica hasta dónde abarca la respuesta.
sort=centralLos temas con más enlaces primero, entre todas las coincidencias hasta un máximo de 1.000.
max_grade={grade}Solo artículos de ese nivel de lectura o inferior.
facets=1Recuentos de coincidencias por tema de nivel superior y por región geográfica, sobre todas las coincidencias hasta un máximo de 1.000 (facets.counted).

Todas las respuestas

fields=a,b conserva solo esas claves de cada resultado (o de la respuesta, cuando no tiene resultados); la envoltura (total, page, next, license) se mantiene. Una respuesta 200 que se puede almacenar en caché incluye un ETag: envíalo de vuelta como If-None-Match y, si la respuesta no ha cambiado, recibirás un 304 sin cuerpo. Last-Modified es la fecha de publicación del corpus y es meramente informativa. Edgepedia-Corpus-Version identifica la versión publicada del corpus, y Content-Digest es el SHA-256 del cuerpo (RFC 9530); el .md de un artículo también incluye ambos.

Más rutas

RutaDevuelve
/api/v1/articles?after={id}&limit={1..1000}Todos los artículos de General, recorridos en un orden fijo: {id, slug, title, api_url} y next (null al final). after= vacío empieza desde el principio, y el recorrido puede reanudarse después de cualquier id, incluso uno eliminado.
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geoLos árboles temático y geográfico completos: nodes: [[id, label, parent index, own articles]]; un id que empieza por un punto continúa el id de su nodo superior.
/api/v1/releasesLas versiones publicadas del corpus, de la más reciente a la más antigua, y current.
/api/v1/healthapplication/health+json: pass, warn o fail (503).
/api/v1/manifestUna redirección a un único archivo JSONL comprimido con gzip, con una línea por artículo: { id, slug, title, updated, sha256, topic } (sha256 del .md del artículo). Descárgalo una vez para crear una réplica de Edgepedia. La suma de comprobación corresponde al texto publicado, antes de las correcciones de los lectores: un artículo modificado desde la publicación por una corrección notificada por un lector no coincidirá con ella hasta la siguiente versión.
/api/v1/changes?since={release}Los archivos de cambios desde esa versión hasta la actual, en orden (el flujo comienza en la 1.5: since=1.5 es la más antigua); cada línea es { op, id, … }, con op igual a uno de los valores added, changed, moved (from_slug es la dirección antigua) o removed.
/api/v1/events/{slug}Las oraciones de un artículo que indican una fecha: { date, precision, text, para }, date como YYYY, YYYY-MM o YYYY-MM-DD (negativa antes de la era común: -0044-03-15). Las fechas a. C. siguen la convención histórica, no los años astronómicos: -0044 es el año 44 a. C. (un analizador estándar de ISO 8601 lo interpretaría como el 45 a. C.). La oración es la prueba: léela antes de tratar la fecha como un hecho.
/api/v1/aliases/{id}Otros nombres de un artículo, incluidas las siglas que aparecen en los artículos («NASA»); se excluyen las faltas de ortografía y las variantes de mayúsculas y minúsculas, y, de dos grafías de un mismo nombre, se conserva la que no lleva puntos («WHO», no «W.H.O.»).

Resolución, anotación y reconciliación

Entra texto libre, salen ids de artículos, sin modelos ni representaciones vectoriales. El texto enviado para anotar, clasificar y analizar geográficamente nunca se registra ni se conserva.

RutaDevuelve
/api/v1/resolve?name=Mercury&context=planetEl artículo al que con mayor probabilidad se refiere un nombre: result, confidence, ambiguous, match (exact, alias, anchor, partial o none) y alternatives. type= conserva los candidatos bajo un id de tema (cuando ninguna de las primeras 30 coincidencias del nombre está allí, la consulta de un solo nombre busca entre las 60 siguientes); limit= de 1 a 10. POST acepta hasta 50: { "names": ["Paris", "Koala"] } o { "queries": [{ "name": "Mercury", "context": "planet" }] }. Un nombre por sí solo que no permite determinar un único artículo devuelve ambiguous: true con la mejor estimación como result; pasa context para elegir.
/api/v1/surface?form=mercuryTodos los artículos a los que los propios enlaces del corpus se referían con esta frase exacta, con el número de enlaces y la proporción de cada uno (commonness).
/api/v1/suggest?prefix=koaPrimero el artículo cuyo título coincide exactamente, luego uno cuyo otro nombre coincide exactamente, después los títulos que comienzan con el prefijo y, por último, otros nombres que también comienzan con él (matched indica ese nombre), para cuadros de búsqueda e interfaces de voz.
POST /api/v1/annotate{ "text": "…" } (como máximo 20.000 caracteres): cada frase enlazada con sus posiciones (start, end, en unidades de código UTF-16, como JavaScript indexa las cadenas: en Python, un carácter fuera del plano multilingüe básico, como un emoji, cuenta como dos), artículo y confianza. ?format=html también devuelve el texto, con los caracteres de HTML escapados y cada frase enlazada.
POST /api/v1/classify{ "text": "…" }: los temas de los que trata el texto, puntuados a partir de las rutas temáticas de los artículos que menciona, y las proporciones de nivel superior.
POST /api/v1/geoparse{ "text": "…" }: los lugares y períodos que nombra, en el árbol geográfico (nodes, regions, places, periods); la rama no geográfica del árbol (geo.nongeo) nunca es un lugar.
/api/v1/mentions?term=CRISPRArtículos que mencionan un tema sin enlazar a su artículo; complete: false significa que se ha recortado la lista de artículos que enlazan a él.
/api/v1/reconcileUn punto de acceso de la API del servicio de reconciliación 0.2: el manifiesto, queries por lotes (GET o POST), sugerencias de entidades, tipos y propiedades, una vista previa y ampliación de datos (title, url, excerpt, topic, topic_path, importance_rank). JSONP con callback=. En OpenRefine: Reconciliar › Iniciar reconciliación › Añadir servicio estándar, y pega https://www.edgepedia.org/api/v1/reconcile.

El grafo de enlaces, las fechas y las listas

Los diagramas (format=mermaid) son texto de Mermaid para un entorno que lo renderice.

RutaDevuelve
/api/v1/links/{slug}Los enlaces del artículo a otros artículos, en orden de lectura, cada uno con su texto de anclaje y su oración.
/api/v1/backlinks/{slug}?page=Los artículos que enlazan a él, a razón de 30 por página, con los más importantes primero y con su texto de anclaje.
/api/v1/path?from=&to=La cadena más corta de enlaces entre dos artículos (como máximo 6 saltos, evitando los nodos muy conectados cuando sea posible), con la oración que permite cada salto. El servidor MCP la llama connect.
/api/v1/compare?a=&b=Dos artículos uno junto al otro: entradillas, rutas temáticas, el tema más específico que comparten, la cadena entre ellos, enlaces comunes y propios, y la tabla de Datos clave de cada uno.
/api/v1/graph/{slug}?depth=1|2&limit=Hasta limit (50 de forma predeterminada, 200 como máximo) de sus vecinos más importantes, y todos los enlaces entre ellos. complete: false (aquí, en los enlaces entrantes y en rank/top) significa que el tiempo asignado a la ruta, de aproximadamente un segundo, ha interrumpido la respuesta; una respuesta así solo se almacena en caché durante un minuto.
POST /api/v1/context{ "ids": [...] }, hasta 50 ids o direcciones (como también los aceptan /rank?ids= y /leads?ids=): los enlaces entre ellos, los artículos con los que la mayoría tienen enlaces, el tema y el lugar más específicos que comparten y la entradilla de cada uno.
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit=Importancia según PageRank: pr suma 1 en todo el corpus; el puesto 1 es el más central. Ten en cuenta los nombres: importance en /search y en los artículos es este puesto como percentil de 0 a 1; el importance de /resolve es el valor bruto de pr, y el de /leads es { pr, rank }.
/api/v1/timeline?topic=|geo=&from=&to=Oraciones fechadas de los artículos de un tema o un lugar, de la más antigua a la más reciente, a razón de 50 por página; los años a. C. son negativos. Un nodo conserva como máximo 200 acontecimientos repartidos entre sus fechas, y from y to filtran esa muestra; una respuesta extraída de una muestra que ha alcanzado ese máximo indica sampled: true y su cap, y su total cuenta la muestra.
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year}Acontecimientos de un día del año (hoy en UTC, de forma predeterminada) o de un año concreto (de -9999 a 2100). Un día contiene como máximo 500 acontecimientos y un año, 2.000; si se alcanza el máximo, indica sampled: true.
/api/v1/featured?date=, /api/v1/featured.xmlEl artículo destacado del día (el Dato del día de la página de inicio) y una fuente Atom de los últimos diez días.
/api/v1/list?topic=|geo=&period=&type=personArtículos de un tema, o de un lugar y un período (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), a razón de 30 por página; type=person conserva las personas. Las filas de una lista geográfica incluyen geo y no incluyen id (consulta el artículo para obtenerlo).
/api/v1/keyterms?topic=|geo=&limit=Títulos y otros nombres de un subárbol, para preparar un sistema de reconocimiento de voz.
/api/v1/stats?topic=|geo=&by=periodSolo recuentos: artículos, enlaces y otros nombres del corpus o de un nodo y sus nodos hijos. Aquí articles cuenta artículos distintos; en /geo y /trees/geo cuenta ubicaciones, de modo que un artículo presente en dos períodos de una región cuenta dos veces allí.

Descubrimiento y otros protocolos

Archivos generados

Se generan a partir de /openapi.json, por lo que nunca se apartan de su contenido.

ArchivoQué es
/openapi-3.0.jsonLa misma descripción en OpenAPI 3.0.3, para herramientas que no leen 3.1.
/arazzo.jsonUn flujo de trabajo Arazzo 1.0: buscar, obtener la mejor coincidencia y, después, sus artículos relacionados.
/tools.jsonCada ruta JSON como una función que un modelo puede llamar, en los formatos de OpenAI, Anthropic y Gemini, y como JSON Schema con su ruta.
/edgepedia.d.tsTipos de TypeScript para cada respuesta y para los parámetros de cada ruta.
/edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.httpUna solicitud de ejemplo por ruta para Postman, Bruno, Insomnia y VS Code o JetBrains.

Envía un User-Agent que indique el nombre de tu programa, como hacen las colecciones (edgepedia-collection/1).