API da Edgepedia
Mais de 500.000 artigos de enciclopédia, e o acervo não para de crescer, em JSON. Grátis. Sem chave, sem cadastro. Uso comercial com atribuição de crédito. Treinamento de IA aberto a todos.
Experimente
- 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
As rotas de leitura usam GET; migração, lotes e texto enviado por você usam POST. Todas as rotas respondem em JSON a qualquer programa ou página da web (o CORS permite todas as origens). Descrição legível por máquina: /openapi.json, com um exemplo de resposta para cada rota; a mesma descrição em OpenAPI 3.0, definições de funções para modelos, tipos TypeScript e coleções de requisições estão listados em Arquivos gerados, abaixo.
Cartões de referência
Selecionado: Cantor's diagonal argument
O título, o resumo completo e o crédito à Edgepedia de um artigo em um cartão para o seu site.
/embed/{id}?theme=auto fornece um cartão pelo ID canônico do artigo. A aparência pode ser auto, light ou dark. O script opcional /assets/edgepedia-embed.js ajusta o quadro ao conteúdo; sem ele, o quadro continua legível e com rolagem.
/embed/{slug} também funciona: redireciona para o cartão no ID do artigo, mantendo o tema. A Edgepedia também é um provedor oEmbed: GET /oembed?url={article or card URL}&format=json retorna o mesmo código de incorporação do gerador acima como html, com título, largura e altura; maxwidth e maxheight são respeitados. Toda página de artigo do corpus Geral inclui um link para seu endereço oEmbed em seu <head>, de modo que WordPress, Discourse e outros consumidores oEmbed transformam um link da Edgepedia colado em um cartão.
Rotas
| Rota | Retorna |
|---|---|
/api/v1/search?q=words | Correspondências em títulos e outros nomes, com as melhores primeiro. Busque pelo nome de um assunto, não por uma pergunta. Cada resultado: id, título, tópico de nível superior, texto de prévia, links e como foi encontrada a correspondência (match, confidence). Palavras que designam um tópico, como "escritores de ficção científica", também retornam topics, um link para seus artigos. limit é o tamanho da página, de 1 a 30 (padrão: 10); page permite percorrer as páginas, e uma página além do fim fica vazia. Outros nomes e grafias incorretas funcionam: "zhu yuanzhang" encontra o imperador Hongwu, e "siddartha" retorna did_you_mean. Mais opções: Busca, abaixo. |
/api/v1/articles/{slug} | O artigo em Markdown, seu caminho de tópicos, suas posições na árvore geográfica (geo), a data da última atualização e a linha de crédito a exibir. Qualquer nome funciona (Mount_Fuji, um título, um endereço completo), e as opções retornam uma seção, uma estrutura de seções, passagens ou outros formatos: Leitura de um artigo, abaixo. |
/api/v1/articles?id={id} | O mesmo, por id. IDs antigos de artigos continuam sendo resolvidos após uma migração do corpus; IDs de tópicos podem mudar quando a árvore é revista. Um endereço pode mudar; o antigo continua respondendo, com moved_from. ids= aceita até 10 de uma vez. |
/api/v1/leads?ids={id},{id} | Até 50 artigos por id, cada um como um resultado de busca (id, título, tópico de nível superior, texto de prévia, links), para uma página de cartões. IDs migrados e mesclados retornam o artigo remanescente, tendo como chave o id solicitado; o id do resultado é canônico. IDs desconhecidos ou indisponíveis são omitidos. |
/api/v1/random | Um artigo aleatório. new=1 seleciona entre os artigos mais recentes; topic= ou geo= seleciona sob um nó. |
/api/v1/related/{slug} | Os vizinhos de um artigo em uma única chamada: até 10 dos mais próximos em seu próprio tópico, 3 de cada um de até 8 tópicos vizinhos e até 10 dos mais próximos em cada nó geográfico ao qual ele pertence. Também ?id={id}. by=links fornece, em vez disso, os artigos citados junto com ele. |
/api/v1/topics | O topo da árvore de temas. |
/api/v1/topics/{id} | O caminho de um tópico, seus subtópicos com a contagem de artigos e todos os artigos sob ele, 30 por página. format=mermaid desenha sua subárvore. |
/api/v1/geo | A árvore geográfica: suas regiões, cada uma com seus períodos. |
/api/v1/geo/{id} | Um nó geográfico, estruturado como um tópico: seu caminho, nós mais específicos e artigos, 30 por página. Uma região lista apenas seus períodos. |
POST /api/v1/ids/translate | Com a migração v1.5 habilitada: envie {"ids":["old-id", "another-id"]} (até 500 IDs distintos). A resposta mapeia os IDs que mudaram para seus remanescentes canônicos; IDs inalterados ou desconhecidos são omitidos. Salve pontos de controle dos lotes concluídos e respeite Retry-After. |
O texto de prévia usa o trecho do corpus quando disponível e, caso contrário, a abertura do artigo. Registros e resultados com um trecho também o incluem como snippet; markdown continua sendo o texto completo do artigo. node, quando presente, é o nó atual do artigo na árvore de conceitos.
Todo artigo também está disponível em Markdown em seu próprio endereço. Acrescente .md: www.edgepedia.org/koala.md.
Servidor MCP
https://www.edgepedia.org/mcp. Adicione-o ao Claude como conector personalizado, ao ChatGPT com o modo de desenvolvedor ativado, ao VS Code ou ao Cursor com um clique, ou a qualquer outro cliente MCP pelo endereço. Sem chave, sem login. Cinco ferramentas somente de leitura: search (recebe o nome de um assunto e retorna artigos correspondentes, além de um tópico quando as palavras designam um), fetch (um artigo em Markdown, com sua linha de crédito, caminho de tópicos e geografia; citations: false para um texto cerca de um quarto mais curto; um id topic: lista o tópico pai, os tópicos mais específicos e os artigos desse tópico, 120 por page; topic:root e topic:geo são os topos das árvores de tópicos e geográfica), related (os vizinhos de um artigo em seu tópico, em tópicos próximos e na geografia; by: "links" para os artigos citados junto com ele), connect (from, to: a cadeia de links entre dois artigos, como fornecida por /api/v1/path) e resolve (name, com context e type opcionais: o artigo ao qual um nome mais provavelmente se refere, como fornecido por /api/v1/resolve). Quando nenhum título corresponde a uma busca search, os artigos cujo texto corresponde vêm depois das correspondências de título, marcados como match: fulltext, dentro de limit e contabilizados em pages. Um erro de ferramenta é um texto que o modelo lê (com IDs did_you_mean para um id que não pertence a nenhum artigo); seu código é enviado em _meta["ai.edgechat/error"], nunca em structuredContent. fetch com links: "in" aceita links_page para os próximos 30 artigos que apontam para ele.
search aceita limit (de 1 a 30, padrão: 10), page, first, topic e sort, e retorna page e pages; fetch aceita as opções de artigo abaixo e ids para vários de uma vez. Todo resultado inclui canonical_id, o id permanente do artigo: fetch o aceita e, quando um id ou endereço que você armazenou tiver mudado, fetch retorna o artigo com moved_from definido como o que você solicitou. Os resultados indicam a versão do corpus em _meta.corpus_version. Clientes no protocolo 2025-06-18 ou posterior também recebem um resource_link por artigo.
Recursos: edgepedia://article/{slug} (um artigo em Markdown, o mesmo texto de fetch) e edgepedia://topic/{id} (os tópicos mais específicos e os artigos de um tópico), com preenchimento automático para ambos; o preenchimento automático também sugere títulos de artigos para qualquer argumento que nomeie um artigo. A habilidade de agente também é disponibilizada por MCP (skills/list, skills/get), como skill://edgepedia/SKILL.md. Um GET de /mcp retorna o cartão do servidor em JSON. Clientes que aceitam apenas text/event-stream recebem cada resposta como um único evento SSE message. O sha256 da lista de ferramentas é enviado no _meta de cada resposta (ai.edgechat/tools-sha256), para que uma alteração na descrição de uma ferramenta fique visível.
Windows (versão preliminar, compilação 26220.7262 ou posterior): odr.exe mcp add --uri https://www.edgepedia.org/mcp. Linhas de configuração para todos os outros clientes, uma habilidade de agente e exemplos: github.com/EdgePlat/edgepedia-mcp.
Sem MCP, ou com um cliente que só usa o transporte SSE antigo? Dê ao seu modelo duas funções que chamem /api/v1/search e /api/v1/articles/{slug}, ou obtenha-as prontas em /tools.json. Os endereços do transporte antigo (/sse, /mcp/sse) respondem com 404 e um corpo que indica https://www.edgepedia.org/mcp.
Limites
600 requisições por minuto e 100.000 por dia por endereço IP, tanto na API quanto no servidor MCP. Toda resposta informa as duas janelas de tempo em RateLimit-Policy. Acima desses limites, a API responde com 429, Retry-After e RateLimit; uma chamada de ferramenta MCP retorna um erro de ferramenta cujo retry_after informa os segundos. As contagens são mantidas por instância do servidor, portanto são um teto a não ultrapassar, não um medidor exato. Por favor, use cache. A conversão de IDs (/ids/translate) contabiliza cada id solicitado separadamente; lotes de /leads que consultam IDs antigos também são contabilizados por id antigo. Outros lotes contabilizam cada id ou nome como uma requisição, e annotate contabiliza uma a cada 1.000 caracteres.
Licença
Licença Comunitária da Edgepedia 1.0: gratuita com atribuição de crédito, inclusive para uso comercial. O treinamento de IA é aberto a todos, e a saída de um modelo não exige crédito. Para outros usos, organizações com receita superior a US$ 100 milhões ou mais de 100 milhões de usuários mensais precisam de uma licença separada.
Crédito: exiba a linha credit de cada artigo, com seu link, onde quer que exiba o texto dele. As respostas de artigos também a incluem pronta para colar como credit_md e credit_html, e license.spdx (LicenseRef-Edgepedia-Community-1.0). As respostas de artigos e de /leads na API incluem Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" e X-License: LicenseRef-Edgepedia-Community-1.0.
O aplicativo EdgeChat, seus Edge Apps e nosso software são gratuitos, mas proprietários: o código-fonte não é fornecido, e eles não podem ser copiados, modificados nem redistribuídos (Contrato de Licença do EdgeChat).
Erros
JSON: { "error": { "code": "not_found", "message": "…" } }. 400: falta q; 404: não encontrado; 410: removido; 413: texto longo demais; 429: requisições em excesso; 503: tente novamente. Um 404 indica a próxima chamada: hint, next (uma URL) e, para um endereço de artigo que não retorna nada, did_you_mean com os três títulos mais próximos. O erro de não encontrado da ferramenta MCP fetch inclui o mesmo did_you_mean.
Alterações
A versão 1 mantém sua estrutura: campos podem ser acrescentados, mas nunca renomeados nem removidos. As alterações da própria Edgepedia estão em /edgepedia/updates. Quando uma versão reorganiza a árvore de tópicos, como ocorreu na 1.8.0, um id de tópico que mudou responde com 301 e seu novo id, e /api/v1/changes?since=<release> lista todos os artigos acrescentados, alterados, movidos ou removidos desde aquela versão.
/api/v1 informa corpus_version, corpus_updated e release_notes. Eles identificam a versão publicada do corpus Geral e sua data de lançamento, não a data da última edição de cada artigo. Os mesmos metadados aparecem nas instruções do servidor MCP. Os lançamentos do corpus não alteram a versão do software da API ou do MCP. Ali, id_policy informa o que um id garante: IDs podem ser renumerados ou mesclados em uma versão, como ocorreu na 1.5, e os IDs antigos continuam respondendo, por meio de um 308 e de POST /api/v1/ids/translate.
Algo não está funcionando? Relate o problema.
Referência
Rotas e campos que consultam dados derivados (importância, níveis de leitura, links, datas, outros nomes e o índice de texto completo) respondem com 503 e Retry-After, ou omitem o campo, até que esses dados sejam publicados junto com o repositório.
Leitura de um artigo
/api/v1/articles/{slug} e o MCP fetch aceitam estas opções; sem elas, a resposta é o artigo inteiro.
| Opção | Retorna |
|---|---|
section={heading} | Uma seção, pelo título ou por uma palavra dele (section=etymology encontra "Name and etymology"; section=lead é a abertura), com suas subseções. Um título desconhecido retorna 404 com o sections do artigo. |
outline=1 | outline: todos os títulos de seção com seus tamanhos em tokens. |
max_tokens={n} | O texto cortado em cerca de n tokens no limite de uma seção ou de um parágrafo, com tokens_estimate, truncated e next_cursor; passe-o como cursor com o mesmo max_tokens para obter o restante. |
length=snippet, length=lead | O trecho, ou o título e o parágrafo de abertura, em vez do texto inteiro. |
format=text, html, jsonld, turtle, tables | A resposta como texto simples, o corpo renderizado ou os campos públicos em JSON-LD ou Turtle; tables fornece cada tabela como columns e rows, como csv e com suas citações movidas para cites e sources. |
chunks=1 | chunks: o artigo em parágrafos, cada um com um id estável derivado do caminho de seus títulos de seção (geology-2) e um cite_url. |
q={words}&k={1–10} | passages: os k parágrafos (padrão: 3) que melhor correspondem às palavras, cada um com um cite_url. |
quote={sentence or chunk id} | cite_url: o endereço do artigo com um fragmento de texto que abre a página naquela passagem; quote_found informa se o artigo a contém. |
cite={format} | cite: uma referência ao artigo, como fornecida por /api/v1/cite. |
Toda resposta de artigo também inclui speakable (o trecho em uma forma que um assistente de voz pode ler). importance e rank (PageRank sobre os links entre artigos; 1 é o mais central; uma contagem de links, não um julgamento sobre o assunto), words, reading_grade (Flesch-Kincaid) e reading_minutes só vêm quando fields= os especifica (?fields=title,importance,rank); o MCP fetch sempre os inclui. next=1 acrescenta até 5 artigos para ler a seguir. citations=false substitui os links de fontes no corpo do texto por marcadores [n] em markdown, chunks e passages, assim como faz citations: false do MCP. Um endereço que não pertence a nenhum artigo é interpretado como o id de um artigo (/api/v1/articles/ep7rbwcy0a) ou como seu título, sem distinguir maiúsculas de minúsculas nem considerar acentos (/api/v1/articles/paris); um endereço em minúsculas e com hífens que se afaste mais do título retorna 404, a menos que você acrescente ?suggest=1, enquanto um endereço com maiúsculas, espaços ou sublinhados (/api/v1/articles/Albert_Einstein) é interpretado como um nome, de modo que uma correspondência aproximada retorna o melhor resultado de busca com resolved_by: search. Quando o nome informado não é o endereço do artigo, a resposta informa como ele foi interpretado (resolved_from, resolved_by: endereço, título ou busca) e lista os outros 3 artigos nearest. /api/v1/articles?ids={slug or id},{name} retorna até 10 em articles (cada um com o nome ao qual responde em asked) e missing; todas as opções se aplicam a cada um.
Como citar um artigo
/api/v1/cite/{slug}?format= fornece uma referência em csl (CSL-JSON, o padrão), bibtex, ris, apa, mla, chicago ou harvard, com a linha de crédito em texto, Markdown e HTML; /api/v1/cite?ids={id},{slug} faz o mesmo para até 50. O autor é Edgepedia (EdgeChat); APA, MLA, Chicago e Harvard marcam o título em itálico com asteriscos, como faz o Markdown. Os cartões de referência incluem a mesma citação de forma invisível, em COinS e JSON-LD, para gerenciadores de referências.
Busca
match | Quando | confidence |
|---|---|---|
exact | O título é igual à consulta. | 1,0 para o primeiro resultado desse tipo, 0,9 para os seguintes |
alias | Houve correspondência com outro nome ou com as iniciais do título ("mlk"). | 0,8; 0,7 para um primeiro resultado sem nenhuma palavra da consulta; 0,6 para uma consulta transliterada |
misspelling | A busca corrigiu a consulta (did_you_mean). | 0,5 × a proporção da consulta digitada que a correção manteve |
partial | Algumas palavras da consulta estão no título, ou apenas no texto. | 0,2 + 0,5 × a proporção de palavras da consulta no título; 0,2 quando estão apenas no texto |
fulltext | Nenhum título ou outro nome correspondeu, então a busca foi feita no texto dos artigos (BM25): uma descrição encontra o artigo cujo nome você não sabe. | pelo menos 0,2 |
none | Nada correspondeu. A resposta está vazia. | 0 |
A confiança segue uma regra fixa, não é uma probabilidade calibrada; uma resposta cujo melhor resultado tenha pontuação inferior a 0,2 vem vazia. Cada resultado inclui highlight, a frase de seu resumo que contém mais palavras da consulta. Uma busca que não encontra nada é tentada mais uma vez em letras latinas (com transliteração de cirílico, grego, kana e hangul, remoção dos números de tom do pinyin e redução das vogais duplicadas do romaji), e a resposta a identifica como searched_as. Caracteres chineses não são transliterados.
| Opção | O que faz |
|---|---|
first=true | Apenas a melhor correspondência, ou nenhuma. |
topic={id}, geo={id} | Apenas artigos sob aquele nó de tópico ou geográfico; geo filtra todas as correspondências até o limite de 1.000, e scope informa o alcance da resposta. |
sort=central | Os assuntos com mais links primeiro, entre todas as correspondências até o limite de 1.000. |
max_grade={grade} | Apenas artigos naquele nível de leitura ou abaixo dele. |
facets=1 | Contagens das correspondências por tópico de nível superior e por região geográfica, considerando todas as correspondências até o limite de 1.000 (facets.counted). |
Todas as respostas
fields=a,b mantém apenas essas chaves de cada resultado (ou da resposta, quando ela não tem resultados); o envelope (total, page, next, license) permanece. Uma resposta 200 que pode ser armazenada em cache inclui um ETag: envie-o de volta como If-None-Match e, se a resposta não tiver mudado, você receberá um 304 sem corpo. Last-Modified é a data de lançamento do corpus e tem caráter apenas informativo. Edgepedia-Corpus-Version identifica a versão do corpus, e Content-Digest é o SHA-256 do corpo (RFC 9530); o .md de um artigo também inclui ambos.
Mais rotas
| Rota | Retorna |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | Todos os artigos do corpus Geral, percorridos em uma ordem fixa: {id, slug, title, api_url} e next (null ao final). after= vazio começa do início, e o percurso pode ser retomado após qualquer id, mesmo um removido. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | As árvores de tópicos e geográfica completas: nodes: [[id, label, parent index, own articles]]; um id que começa com ponto dá continuidade ao id do nó pai. |
/api/v1/releases | As versões do corpus, da mais recente para a mais antiga, e current. |
/api/v1/health | application/health+json: pass, warn ou fail (503). |
/api/v1/manifest | Um redirecionamento para um único arquivo JSONL comprimido com gzip, com uma linha por artigo: { id, slug, title, updated, sha256, topic } (sha256 do .md do artigo). Baixe-o uma vez para criar um espelho da Edgepedia. A soma de verificação é a do texto publicado, antes das correções apontadas por leitores: um artigo alterado desde o lançamento por uma correção apontada por um leitor não terá a mesma soma até a próxima versão. |
/api/v1/changes?since={release} | Os arquivos de alterações daquela versão até a atual, em ordem (o feed começa na 1.5: since=1.5 é a mais antiga); cada linha é { op, id, … }, com op sendo um entre added, changed, moved (from_slug é o endereço antigo) ou removed. |
/api/v1/events/{slug} | As frases de um artigo que informam uma data: { date, precision, text, para }, date como YYYY, YYYY-MM ou YYYY-MM-DD (negativo antes da era comum: -0044-03-15). As datas a.C. seguem a convenção histórica, não os anos astronômicos: -0044 é 44 a.C. (um analisador padrão de ISO 8601 o interpretaria como 45 a.C.). A frase é a evidência: leia-a antes de tratar a data como um fato. |
/api/v1/aliases/{id} | Outros nomes de um artigo, incluindo as siglas que os artigos informam ("NASA"); grafias incorretas e variantes de maiúsculas e minúsculas ficam de fora, e, de duas grafias de um mesmo nome, mantém-se a sem pontos ("WHO", não "W.H.O."). |
Resolução, anotação e reconciliação
Entra texto livre, saem IDs de artigos, sem modelo nem embeddings. O texto enviado a annotate, classify e geoparse nunca é registrado nem armazenado.
| Rota | Retorna |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | O artigo ao qual um nome mais provavelmente se refere: result, confidence, ambiguous, match (exact, alias, anchor, partial ou none) e alternatives. type= mantém os candidatos sob um id de tópico (quando nenhuma das primeiras 30 correspondências do nome está ali, uma consulta de nome único examina as 60 seguintes); limit= de 1 a 10. POST aceita até 50: { "names": ["Paris", "Koala"] } ou { "queries": [{ "name": "Mercury", "context": "planet" }] }. Um nome que, sozinho, não permite determinar um artigo retorna ambiguous: true com a melhor hipótese em result; passe context para escolher. |
/api/v1/surface?form=mercury | Todos os artigos aos quais os próprios links do corpus se referem com essa expressão exata, com as contagens de links e a proporção de cada um (commonness). |
/api/v1/suggest?prefix=koa | Primeiro o artigo com esse título exato, depois um cujo outro nome corresponda exatamente, depois títulos que começam com o prefixo e, por fim, outros nomes que também começam (matched fornece esse nome), para caixas de busca e interfaces de voz. |
POST /api/v1/annotate | { "text": "…" } (no máximo 20.000 caracteres): cada expressão vinculada com suas posições (start, end, em unidades de código UTF-16, como o JavaScript indexa strings: em Python, um caractere fora do Plano Multilíngue Básico, como um emoji, conta como dois), artigo e confiança. ?format=html também retorna o texto, com escape de HTML e cada expressão transformada em link. |
POST /api/v1/classify | { "text": "…" }: os tópicos de que o texto trata, com pontuações calculadas a partir dos caminhos de tópicos dos artigos que ele menciona, e as proporções de nível superior. |
POST /api/v1/geoparse | { "text": "…" }: os lugares e períodos que ele menciona, na árvore geográfica (nodes, regions, places, periods); o ramo não geográfico da árvore (geo.nongeo) nunca é um lugar. |
/api/v1/mentions?term=CRISPR | Artigos que mencionam um assunto sem incluir um link para o artigo dele; complete: false significa que a lista de artigos que apontam para ele foi cortada. |
/api/v1/reconcile | Um endpoint da API de Serviço de Reconciliação 0.2: o manifesto, queries em lote (GET ou POST), sugestões de entidades, tipos e propriedades, uma prévia e extensão de dados (title, url, excerpt, topic, topic_path, importance_rank). JSONP com callback=. No OpenRefine: Reconciliar › Iniciar reconciliação › Adicionar serviço padrão, e cole https://www.edgepedia.org/api/v1/reconcile. |
O grafo de links, datas e listas
Os diagramas (format=mermaid) são texto Mermaid para um ambiente que o renderize.
| Rota | Retorna |
|---|---|
/api/v1/links/{slug} | Os links do artigo para outros artigos, na ordem de leitura, cada um com seu texto-âncora e sua frase. |
/api/v1/backlinks/{slug}?page= | Os artigos que apontam para ele, 30 por página, os mais importantes primeiro, com seus textos-âncora. |
/api/v1/path?from=&to= | A cadeia mais curta de links entre dois artigos (no máximo 6 saltos, evitando nós muito conectados quando possível), com a frase que faz cada salto. O servidor MCP a chama de connect. |
/api/v1/compare?a=&b= | Dois artigos lado a lado: aberturas, caminhos de tópicos, o tópico mais profundo que compartilham, a cadeia entre eles, links em comum e exclusivos e a tabela de Fatos principais de cada um. |
/api/v1/graph/{slug}?depth=1|2&limit= | Até limit (padrão: 50, no máximo 200) de seus vizinhos mais importantes e todos os links entre eles. complete: false (aqui, em backlinks e em rank/top) significa que o limite de tempo da rota, de cerca de um segundo, interrompeu a resposta; uma resposta assim fica em cache por apenas um minuto. |
POST /api/v1/context | { "ids": [...] }, até 50 IDs ou endereços (como /rank?ids= e /leads?ids= também aceitam): os links entre eles, os artigos com os quais a maioria deles tem links, o tópico e o lugar mais profundos que compartilham e a abertura de cada um. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | Importância por PageRank: a soma de pr em todo o corpus é 1, e a posição 1 é a mais central. Atenção aos nomes: importance em /search e nos artigos é essa posição como um percentil de 0 a 1; o importance de /resolve é o pr bruto, e o de /leads é { pr, rank }. |
/api/v1/timeline?topic=|geo=&from=&to= | Frases com datas dos artigos de um tópico ou de um lugar, das mais antigas para as mais recentes, 50 por página; anos negativos para a.C. Um nó mantém no máximo 200 eventos distribuídos por suas datas, e from e to filtram essa amostra; uma resposta extraída de uma amostra que atingiu o limite informa sampled: true e seu cap, e seu total conta a amostra. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | Eventos em um dia do ano (por padrão, hoje em UTC) ou em um ano (-9999 a 2100). Um dia comporta no máximo 500 eventos, e um ano, 2.000; quando o limite é atingido, a resposta informa sampled: true. |
/api/v1/featured?date=, /api/v1/featured.xml | O artigo em destaque do dia (o Fato do dia da página inicial) e um feed Atom dos últimos dez dias. |
/api/v1/list?topic=|geo=&period=&type=person | Artigos de um tópico, ou de um lugar e período (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), 30 por página; type=person mantém as pessoas. As linhas de uma lista geográfica incluem geo e não incluem id (consulte o artigo para obtê-lo). |
/api/v1/keyterms?topic=|geo=&limit= | Títulos e outros nomes de uma subárvore, para preparar um reconhecedor de fala. |
/api/v1/stats?topic=|geo=&by=period | Apenas contagens: artigos, links e outros nomes do corpus ou de um nó e seus filhos. Aqui, articles conta artigos distintos; em /geo e /trees/geo, conta as posições ocupadas na árvore, de modo que um artigo em dois períodos de uma região conta duas vezes ali. |
Descoberta e outros protocolos
- Cartão do servidor MCP: /.well-known/mcp/server-card.json (também
/mcp/server-card): nome, endpoint, ferramentas e versões, sem precisar se conectar. Configuração do registro:/.well-known/mcp/config-schema.jsone/.well-known/mcp/examples.json. - Catálogo de IA: /.well-known/ai-catalog.json: todas as formas de acesso (MCP, esta API, A2A, NLWeb e a habilidade de agente), com exemplos de consultas.
- Catálogo de APIs: /.well-known/api-catalog, um conjunto de links conforme a RFC 9727 que indica esta API, sua descrição e esta documentação.
- Habilidade de agente: /.well-known/agent-skills/index.json lista
SKILL.mdcom seu resumo criptográfico sha256. - OpenSearch: /opensearch.xml adiciona a Edgepedia como provedor de busca.
- A2A:
https://www.edgepedia.org/a2a(JSON-RPC; A2A 1.0SendMessagee 0.3message/send; cartão em/.well-known/agent-card.json). O nome de um assunto retorna os cinco primeiros artigos; o endereço de um artigo retorna o artigo em Markdown com sua linha de crédito. A resposta é sempre uma mensagem, nunca uma tarefa, e os mesmos métodos também são atendidos em/mcp. - NLWeb:
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET, ou POST com corpo em JSON ou de formulário) responde no formato de lista do NLWeb, com umschema_objectdo schema.org por resultado;streaming=trueenvia a lista como eventos enviados pelo servidor. Nenhum modelo é chamado. - Representações de um artigo para máquinas: o endereço do artigo retorna a representação indicada pelo cabeçalho
Accept:text/markdown(com uma estimativa dex-markdown-tokens),application/json(a resposta desta API) ouapplication/ld+json; qualquer outro valor retorna a página. As páginas dos artigos incluem um cabeçalhoLinkque indica essas representações, a licença, o catálogo de APIs e a descrição OpenAPI.
Arquivos gerados
Gerados a partir de /openapi.json, para que nunca fiquem em desacordo com ele.
| Arquivo | O que é |
|---|---|
| /openapi-3.0.json | A mesma descrição em OpenAPI 3.0.3, para ferramentas que não leem a versão 3.1. |
| /arazzo.json | Um fluxo de trabalho Arazzo 1.0: buscar, obter a melhor correspondência e, em seguida, seus artigos relacionados. |
| /tools.json | Cada rota JSON como uma função que um modelo pode chamar, nos formatos da OpenAI, da Anthropic e do Gemini, e como JSON Schema com sua rota. |
| /edgepedia.d.ts | Tipos TypeScript para todas as respostas e os parâmetros de cada rota. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Um exemplo de requisição por rota para Postman, Bruno, Insomnia e VS Code ou JetBrains. |
Por favor, envie um User-Agent que identifique seu programa, como fazem as coleções (edgepedia-collection/1).