API Edgepedia
Plus de 500 000 articles encyclopédiques, et toujours davantage, au format JSON. Gratuit. Sans clé ni inscription. Utilisation commerciale autorisée avec mention de la source. Entraînement de l’IA ouvert à tous.
Essayer
- 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
Les routes de lecture utilisent GET ; la migration, les traitements par lots et l’envoi de texte utilisent POST. Chaque route renvoie du JSON à tout programme ou toute page web (CORS autorise toutes les origines). Description exploitable par machine : /openapi.json, avec un exemple de réponse pour chaque route ; cette même description au format OpenAPI 3.0, des définitions de fonctions pour les modèles, des types TypeScript et des collections de requêtes figurent dans la rubrique Fichiers générés, ci-dessous.
Fiches de référence
Article sélectionné : Cantor's diagonal argument
Le titre d’un article, son résumé intégral et la mention de source Edgepedia, réunis dans une fiche pour votre site web.
/embed/{id}?theme=auto fournit une fiche à partir de l’identifiant canonique de l’article. L’apparence peut être auto, light ou dark. Le script facultatif /assets/edgepedia-embed.js adapte le cadre à son contenu ; sans lui, le cadre reste lisible et permet le défilement.
/embed/{slug} fonctionne aussi : il redirige vers la fiche correspondant à l’identifiant de l’article, en conservant le thème. Edgepedia est également un fournisseur oEmbed : GET /oembed?url={article or card URL}&format=json renvoie le même code d’intégration que le générateur ci-dessus, sous la forme html, avec le titre, la largeur et la hauteur ; maxwidth et maxheight sont pris en compte. Chaque page d’article du corpus Général indique son adresse oEmbed dans son <head> : WordPress, Discourse et les autres clients oEmbed peuvent ainsi transformer un lien Edgepedia collé dans leur éditeur en fiche.
Routes
| Route | Renvoie |
|---|---|
/api/v1/search?q=words | Les correspondances avec les titres et les autres noms, les plus pertinentes en premier. Recherchez le nom d’un sujet, et non une question. Chaque résultat comprend : identifiant, titre, thème de premier niveau, texte d’aperçu, liens et type de correspondance (match, confidence). Les termes qui désignent un thème, comme « auteurs de science-fiction », renvoient aussi topics, un lien vers les articles de ce thème. limit définit la taille de la page, de 1 à 30 (10 par défaut) ; page permet de changer de page, et une page au-delà de la dernière est vide. Les autres noms et les fautes d’orthographe fonctionnent aussi : « zhu yuanzhang » trouve l’empereur Hongwu, et « siddartha » renvoie did_you_mean. Autres options : voir Recherche, ci-dessous. |
/api/v1/articles/{slug} | L’article en Markdown, son chemin dans l’arborescence thématique, ses emplacements dans l’arborescence géographique (geo), sa date de dernière mise à jour et la mention de source à afficher. Tout nom convient (Mount_Fuji, un titre, une adresse complète), et des options permettent d’obtenir une section, un plan, des passages ou d’autres formats : voir Lire un article, ci-dessous. |
/api/v1/articles?id={id} | La même chose, par identifiant. Les anciens identifiants d’articles continuent de fonctionner après une migration du corpus ; les identifiants de thèmes peuvent changer lorsque l’arborescence est révisée. Une adresse peut changer ; l’ancienne continue de répondre, avec moved_from. ids= en accepte jusqu’à 10 à la fois. |
/api/v1/leads?ids={id},{id} | Jusqu’à 50 articles par identifiant, chacun sous la forme d’un résultat de recherche (identifiant, titre, thème de premier niveau, texte d’aperçu, liens), pour constituer une page de fiches. Les identifiants migrés ou fusionnés renvoient l’article conservé, sous la clé de l’identifiant demandé ; le champ id du résultat est canonique. Les identifiants inconnus ou indisponibles sont omis. |
/api/v1/random | Un article au hasard. new=1 sélectionne parmi les articles les plus récents ; topic= ou geo= sélectionne sous un nœud. |
/api/v1/related/{slug} | Les articles voisins d’un article en un seul appel : jusqu’aux 10 plus proches dans son propre thème, 3 dans chacun de 8 thèmes voisins au maximum, et jusqu’aux 10 plus proches dans chaque nœud géographique auquel il appartient. Également ?id={id}. by=links renvoie plutôt les articles cités avec lui. |
/api/v1/topics | La racine de l’arborescence thématique. |
/api/v1/topics/{id} | Le chemin d’un thème, ses sous-thèmes avec leur nombre d’articles, et tous les articles qui en relèvent, à raison de 30 par page. format=mermaid dessine sa sous-arborescence. |
/api/v1/geo | L’arborescence géographique : ses régions, chacune avec ses périodes. |
/api/v1/geo/{id} | Un nœud géographique, structuré comme un thème : son chemin, ses nœuds plus spécifiques et ses articles, à raison de 30 par page. Une région ne répertorie que ses périodes. |
POST /api/v1/ids/translate | Lorsque la migration v1.5 est activée : envoyez {"ids":["old-id", "another-id"]} (jusqu’à 500 identifiants distincts). La réponse associe les identifiants déplacés aux identifiants canoniques conservés ; les identifiants inchangés ou inconnus sont omis. Enregistrez un point de reprise après chaque lot terminé et respectez Retry-After. |
Le texte d’aperçu utilise l’extrait du corpus lorsqu’il est disponible, et le début de l’article dans le cas contraire. Les enregistrements et les résultats pourvus d’un extrait l’incluent aussi dans snippet ; markdown reste le texte intégral de l’article. node, lorsqu’il est présent, correspond au nœud actuel de l’article dans l’arborescence des concepts.
Chaque article est aussi disponible en Markdown à sa propre adresse. Ajoutez .md : www.edgepedia.org/koala.md.
Serveur MCP
https://www.edgepedia.org/mcp. Ajoutez-le à Claude comme connecteur personnalisé, à ChatGPT avec le mode développeur activé, à VS Code ou à Cursor en un clic, ou à tout autre client MCP à l’aide de son adresse. Sans clé ni connexion. Cinq outils en lecture seule : search (prend le nom d’un sujet et renvoie les articles correspondants, ainsi qu’un thème lorsque les termes en désignent un), fetch (un article en Markdown, avec sa mention de source, son chemin thématique et sa situation géographique ; citations: false pour un texte plus court d’environ un quart ; un identifiant topic: répertorie le thème parent, les thèmes plus spécifiques et les articles de ce thème, à raison de 120 par page ; topic:root et topic:geo sont les racines des arborescences thématique et géographique), related (les articles voisins d’un article dans son thème, dans les thèmes proches et dans l’arborescence géographique ; by: "links" pour les articles cités avec lui), connect (from, to : la chaîne de liens entre deux articles, telle que la fournit /api/v1/path) et resolve (name, avec context et type en option : l’article qu’un nom désigne le plus probablement, tel que le fournit /api/v1/resolve). Lorsqu’un search ne trouve aucune correspondance dans les titres, les articles dont le texte correspond suivent les correspondances de titre, avec la marque match: fulltext, dans la limite de limit et comptabilisés dans pages. Une erreur d’outil est un texte que le modèle lit (avec des identifiants did_you_mean lorsqu’aucun article ne possède l’identifiant demandé) ; son code est transmis dans _meta["ai.edgechat/error"], jamais dans structuredContent. fetch avec links: "in" accepte links_page pour obtenir les 30 articles suivants qui pointent vers cet article.
search accepte limit (de 1 à 30, 10 par défaut), page, first, topic et sort, et renvoie page et pages ; fetch accepte les options d’article ci-dessous, ainsi que ids pour en obtenir plusieurs à la fois. Chaque résultat contient canonical_id, l’identifiant permanent de l’article : fetch l’accepte, et lorsqu’un identifiant ou une adresse que vous avez enregistrés a changé, fetch renvoie l’article en donnant à moved_from la valeur que vous avez demandée. Les résultats indiquent la version du corpus dans _meta.corpus_version. Les clients utilisant le protocole 2025-06-18 ou ultérieur reçoivent aussi un resource_link par article.
Ressources : edgepedia://article/{slug} (un article en Markdown, avec le même texte que fetch) et edgepedia://topic/{id} (les thèmes plus spécifiques et les articles d’un thème), avec autocomplétion pour les deux ; l’autocomplétion propose aussi des titres d’articles pour tout argument qui désigne un article. L’Agent Skill est également accessible par MCP (skills/list, skills/get), sous la forme skill://edgepedia/SKILL.md. Un GET de /mcp renvoie la fiche du serveur en JSON. Les clients qui n’acceptent que text/event-stream reçoivent chaque réponse sous la forme d’un seul événement SSE message. Le sha256 de la liste des outils est transmis dans le _meta de chaque réponse (ai.edgechat/tools-sha256), ce qui rend visible toute modification de la description d’un outil.
Windows (en préversion, build 26220.7262 ou ultérieur) : odr.exe mcp add --uri https://www.edgepedia.org/mcp. Lignes de configuration pour tous les autres clients, Agent Skill et exemples : github.com/EdgePlat/edgepedia-mcp.
Pas de MCP, ou un client qui ne prend en charge que l’ancien transport SSE ? Donnez à votre modèle deux fonctions qui appellent /api/v1/search et /api/v1/articles/{slug}, ou récupérez-les prêtes à l’emploi dans /tools.json. Les adresses de l’ancien transport (/sse, /mcp/sse) renvoient une erreur 404 dont le corps indique https://www.edgepedia.org/mcp.
Limites
600 requêtes par minute et 100 000 par jour et par adresse IP, pour l’API comme pour le serveur MCP. Chaque réponse indique les deux fenêtres temporelles dans RateLimit-Policy. Au-delà, l’API renvoie une erreur 429 avec Retry-After et RateLimit ; un appel d’outil MCP renvoie une erreur d’outil dont le champ retry_after indique le nombre de secondes. Les compteurs sont propres à chaque instance du serveur : il s’agit donc de plafonds à ne pas dépasser, et non d’une mesure exacte. Veuillez utiliser un cache. La conversion d’identifiants (POST /api/v1/ids/translate) compte séparément chaque identifiant demandé ; les lots /leads qui testent d’anciens identifiants sont eux aussi décomptés par ancien identifiant. Pour les autres lots, chaque identifiant ou nom compte pour une requête, et l’annotation compte pour une requête par tranche de 1 000 caractères.
Licence
Edgepedia Community License 1.0 : gratuit avec mention de la source, y compris pour un usage commercial. L’entraînement de l’IA est ouvert à tous, et les productions d’un modèle ne nécessitent aucune mention de source. Pour les autres usages, les organisations dont le chiffre d’affaires dépasse 100 millions de dollars américains ou qui comptent plus de 100 millions d’utilisateurs mensuels doivent souscrire une licence distincte.
Mention de la source : affichez la ligne credit de chaque article, avec son lien, partout où vous présentez son texte. Les réponses contenant un article la fournissent aussi, prête à coller, dans credit_md et credit_html, et indiquent la licence dans license.spdx (LicenseRef-Edgepedia-Community-1.0). Les réponses des routes d’articles et de /leads de l’API comprennent Link: <https://www.edgepedia.org/edgepedia/license>; rel="license" et X-License: LicenseRef-Edgepedia-Community-1.0.
L’application EdgeChat, ses Edge Apps et nos logiciels sont gratuits mais propriétaires : aucun code source n’est fourni, et ils ne peuvent être ni copiés, ni modifiés, ni redistribués (EdgeChat License Agreement).
Erreurs
JSON : { "error": { "code": "not_found", "message": "…" } }. 400 : q manquant ; 404 : introuvable ; 410 : supprimé ; 413 : texte trop long ; 429 : trop de requêtes ; 503 : réessayez. Une erreur 404 indique le prochain appel à effectuer : hint, next (une URL) et, pour une adresse d’article qui ne renvoie rien, did_you_mean avec les trois titres les plus proches. L’erreur « introuvable » de l’outil MCP fetch contient le même did_you_mean.
Modifications
La version 1 conserve sa structure : des champs peuvent être ajoutés, mais jamais renommés ni supprimés. Les modifications propres à Edgepedia figurent à l’adresse /edgepedia/updates. Lorsqu’une version réorganise l’arborescence thématique, comme l’a fait la version 1.8.0, un identifiant de thème qui a changé renvoie un code 301 avec son nouvel identifiant, et /api/v1/changes?since=<release> répertorie tous les articles ajoutés, modifiés, déplacés ou supprimés depuis cette version.
/api/v1 indique corpus_version, corpus_updated et release_notes. Ces champs identifient la version publiée du corpus Général et sa date de publication, et non la date de dernière modification de chaque article. Les mêmes métadonnées figurent dans les instructions du serveur MCP. Les nouvelles versions du corpus ne changent pas la version des logiciels de l’API ou du serveur MCP. id_policy y précise les garanties associées à un identifiant : une nouvelle version peut renuméroter ou fusionner des identifiants, comme l’a fait la version 1.5, et les anciens identifiants continuent de répondre, au moyen d’un code 308 et de POST /api/v1/ids/translate.
Quelque chose ne fonctionne pas ? Signalez-le.
Référence
Les routes et les champs qui s’appuient sur des données dérivées (importance, niveaux de lecture, liens, dates, autres noms et index de recherche en texte intégral) renvoient une erreur 503 avec Retry-After, ou omettent le champ, tant que ces données ne sont pas publiées avec le dépôt de données.
Lire un article
/api/v1/articles/{slug} et l’outil MCP fetch acceptent les options suivantes ; sans elles, la réponse contient l’article entier.
| Option | Renvoie |
|---|---|
section={heading} | Une section, désignée par son titre ou un mot de celui-ci (section=etymology trouve « Name and etymology » ; section=lead correspond à l’introduction), avec ses sous-sections. Un titre inconnu renvoie une erreur 404 avec le champ sections de l’article. |
outline=1 | outline : tous les titres de section avec leur taille en jetons. |
max_tokens={n} | Le texte limité à environ n jetons, coupé à la fin d’une section ou d’un paragraphe, avec tokens_estimate, truncated et next_cursor ; transmettez cette valeur comme cursor avec le même max_tokens pour obtenir la suite. |
length=snippet, length=lead | L’extrait, ou le titre et le premier paragraphe, à la place du texte intégral. |
format=text, html, jsonld, turtle, tables | La réponse en texte brut, le corps mis en forme, ou les champs publics en JSON-LD ou en Turtle ; tables fournit chaque tableau sous les formes columns et rows, sous la forme csv, et avec ses citations déplacées dans cites et sources. |
chunks=1 | chunks : l’article découpé en paragraphes, chacun doté d’un identifiant stable issu de la hiérarchie de ses titres de section (geology-2) et d’un cite_url. |
q={words}&k={1–10} | passages : les k paragraphes (3 par défaut) qui correspondent le mieux aux termes, chacun avec un cite_url. |
quote={sentence or chunk id} | cite_url : l’adresse de l’article avec un fragment de texte qui ouvre la page au passage concerné ; quote_found indique si l’article le contient. |
cite={format} | cite : une référence à l’article, telle que la fournit /api/v1/cite. |
Chaque réponse contenant un article comprend aussi speakable (l’extrait sous une forme lisible par un assistant vocal). importance et rank (PageRank calculé sur les liens entre articles ; 1 désigne le plus central ; il s’agit d’un décompte de liens, pas d’un jugement sur le sujet), words, reading_grade (Flesch-Kincaid) et reading_minutes ne sont fournis que si fields= les désigne (?fields=title,importance,rank) ; l’outil MCP fetch les fournit toujours. next=1 ajoute jusqu’à 5 articles à lire ensuite. citations=false remplace les liens vers les sources insérés dans le texte par des repères [n], dans markdown, chunks et passages, comme le fait citations: false pour MCP. Une adresse qui ne correspond à aucun article est interprétée comme un identifiant d’article (/api/v1/articles/ep7rbwcy0a) ou comme son titre, sans tenir compte de la casse ni des accents (/api/v1/articles/paris) ; une adresse en minuscules avec des traits d’union qui s’en écarte davantage renvoie une erreur 404, sauf si vous ajoutez ?suggest=1, tandis qu’une adresse comportant des majuscules, des espaces ou des traits de soulignement (/api/v1/articles/Albert_Einstein) est interprétée comme un nom : une correspondance approximative renvoie alors le meilleur résultat de recherche avec resolved_by: search. Lorsque le nom fourni n’est pas l’adresse de l’article, la réponse indique comment il a été interprété (resolved_from, resolved_by : address, title ou search) et répertorie dans nearest les 3 autres articles les plus proches. /api/v1/articles?ids={slug or id},{name} en renvoie jusqu’à 10 sous la forme articles (chacun avec le nom auquel il répond dans asked) et missing ; chaque option s’applique à chacun.
Citer un article
/api/v1/cite/{slug}?format= fournit une référence au format csl (CSL-JSON, par défaut), bibtex, ris, apa, mla, chicago ou harvard, avec la mention de source en texte brut, en Markdown et en HTML ; /api/v1/cite?ids={id},{slug} fait de même pour un maximum de 50 articles. L’auteur est Edgepedia (EdgeChat) ; les styles APA, MLA, Chicago et Harvard encadrent le titre en italique d’astérisques, comme en Markdown. Les fiches de référence contiennent la même référence, invisible à l’affichage, aux formats COinS et JSON-LD, pour les logiciels de gestion bibliographique.
Recherche
match | Cas | confidence |
|---|---|---|
exact | Le titre correspond à la requête. | 1,0 pour le premier résultat de ce type, 0,9 pour les suivants |
alias | Un autre nom, ou les initiales du titre (« mlk »), correspond. | 0,8 ; 0,7 pour un premier résultat ne contenant aucun mot de la requête ; 0,6 pour une requête translittérée |
misspelling | La recherche a corrigé la requête (did_you_mean). | 0,5 × la proportion de la requête saisie conservée par la correction |
partial | Certains mots de la requête figurent dans le titre, ou seulement dans le texte. | 0,2 + 0,5 × la proportion des mots de la requête présents dans le titre ; 0,2 pour le texte seul |
fulltext | Aucun titre ni autre nom ne correspondait : la recherche a donc porté sur le texte des articles (BM25). Une description permet de trouver l’article dont vous ne connaissez pas le nom. | au moins 0,2 |
none | Aucune correspondance. La réponse est vide. | 0 |
Le score de confiance obéit à une règle fixe ; ce n’est pas une probabilité calibrée. Une réponse dont le meilleur résultat obtient un score inférieur à 0,2 est renvoyée vide. Chaque résultat comprend highlight, la phrase de son résumé qui contient le plus de mots de la requête. Une recherche infructueuse est tentée une seconde fois en caractères latins (translittération du cyrillique, du grec, des kana et du hangeul, suppression des chiffres de ton du pinyin, réduction des voyelles doubles du rōmaji), et la réponse l’indique dans searched_as. Les caractères chinois ne sont pas translittérés.
| Option | Effet |
|---|---|
first=true | Uniquement la meilleure correspondance, ou aucune. |
topic={id}, geo={id} | Uniquement les articles relevant de ce nœud thématique ou géographique ; geo filtre toutes les correspondances, jusqu’à 1 000, et scope indique l’étendue des résultats couverts par la réponse. |
sort=central | Les sujets qui reçoivent le plus de liens en premier, parmi toutes les correspondances, jusqu’à 1 000. |
max_grade={grade} | Uniquement les articles dont le niveau de lecture ne dépasse pas le niveau scolaire indiqué. |
facets=1 | Le nombre de correspondances par thème de premier niveau et par région géographique, sur l’ensemble des correspondances, jusqu’à 1 000 (facets.counted). |
Chaque réponse
fields=a,b ne conserve que les clés indiquées de chaque résultat (ou de la réponse, lorsqu’elle ne contient pas de résultats) ; l’enveloppe (total, page, next, license) est conservée. Une réponse 200 pouvant être mise en cache comprend un ETag : renvoyez-le dans If-None-Match et, si la réponse n’a pas changé, vous recevrez un 304 sans corps. Last-Modified est la date de publication de la version du corpus et n’a qu’une valeur informative. Edgepedia-Corpus-Version désigne la version du corpus, et Content-Digest est le SHA-256 du corps (RFC 9530) ; le .md d’un article comprend lui aussi ces deux éléments.
Autres routes
| Route | Renvoie |
|---|---|
/api/v1/articles?after={id}&limit={1..1000} | Tous les articles du corpus Général, parcourus dans un ordre fixe : {id, slug, title, api_url} et next (null à la fin). Un after= vide commence au début, et le parcours peut reprendre après n’importe quel identifiant, même supprimé. |
/api/v1/trees, /api/v1/trees/topic, /api/v1/trees/geo | Les arborescences thématique et géographique complètes : nodes: [[id, label, parent index, own articles]] ; un identifiant commençant par un point prolonge celui de son parent. |
/api/v1/releases | Les versions du corpus, de la plus récente à la plus ancienne, et current. |
/api/v1/health | application/health+json : pass, warn ou fail (503). |
/api/v1/manifest | Une redirection vers un unique fichier JSONL compressé avec gzip, à raison d’une ligne par article : { id, slug, title, updated, sha256, topic } (sha256 du .md de l’article). Téléchargez-le une seule fois pour créer un miroir d’Edgepedia. La somme de contrôle porte sur le texte publié, avant les corrections signalées par les lecteurs : un article modifié à la suite d’un tel signalement depuis la publication de la version ne correspondra plus à cette somme jusqu’à la version suivante. |
/api/v1/changes?since={release} | Les fichiers de modifications entre cette version et la version actuelle, dans l’ordre (le flux commence à la version 1.5 : since=1.5 est la plus ancienne) ; chaque ligne est { op, id, … }, op prenant l’une des valeurs added, changed, moved (from_slug est l’ancienne adresse) ou removed. |
/api/v1/events/{slug} | Les phrases d’un article qui énoncent une date : { date, precision, text, para }, date sous la forme YYYY, YYYY-MM ou YYYY-MM-DD (valeur négative avant l’ère commune : -0044-03-15). Les dates avant notre ère suivent la convention historique, et non la numérotation astronomique des années : -0044 correspond à 44 avant notre ère (un analyseur ISO 8601 standard l’interpréterait comme 45 avant notre ère). La phrase est la pièce justificative : lisez-la avant de tenir la date pour un fait. |
/api/v1/aliases/{id} | Les autres noms d’un article, y compris les sigles mentionnés dans les articles (« NASA ») ; les fautes d’orthographe et les variantes de casse sont exclues, et, entre deux graphies d’un même nom, celle sans points est conservée (« WHO », et non « W.H.O. »). |
Résolution, annotation et réconciliation
Du texte libre en entrée, des identifiants d’articles en sortie, sans modèle ni plongements vectoriels. Le texte envoyé aux routes d’annotation, de classification et d’analyse géographique n’est jamais journalisé ni conservé.
| Route | Renvoie |
|---|---|
/api/v1/resolve?name=Mercury&context=planet | L’article qu’un nom désigne le plus probablement : result, confidence, ambiguous, match (exact, alias, anchor, partial ou none) et alternatives. type= ne conserve que les candidats relevant d’un identifiant de thème (si aucune des 30 premières correspondances du nom n’en relève, une requête portant sur un seul nom examine les 60 suivantes) ; limit= va de 1 à 10. POST en accepte jusqu’à 50 : { "names": ["Paris", "Koala"] } ou { "queries": [{ "name": "Mercury", "context": "planet" }] }. Lorsqu’un nom seul ne permet pas de trancher en faveur d’un article, la réponse indique ambiguous: true, avec le candidat le plus probable dans result ; transmettez context pour choisir. |
/api/v1/surface?form=mercury | Tous les articles que les liens du corpus lui-même désignent par cette expression exacte, avec le nombre de liens et la part de chacun (commonness). |
/api/v1/suggest?prefix=koa | D’abord l’article dont le titre correspond exactement, puis celui dont un autre nom correspond exactement, puis les titres commençant par le préfixe, puis les autres noms commençant par celui-ci (matched fournit ce nom), pour les champs de recherche et les interfaces vocales. |
POST /api/v1/annotate | { "text": "…" } (20 000 caractères au maximum) : chaque expression liée, avec ses positions (start, end, en unités de code UTF-16, selon l’indexation des chaînes en JavaScript : en Python, un caractère hors du plan multilingue de base, comme un émoji, compte pour deux), l’article et le score de confiance. ?format=html renvoie aussi le texte, avec échappement HTML, chaque expression étant munie d’un lien. |
POST /api/v1/classify | { "text": "…" } : les thèmes abordés dans le texte, avec un score établi à partir des chemins thématiques des articles qu’il mentionne, et les proportions par thème de premier niveau. |
POST /api/v1/geoparse | { "text": "…" } : les lieux et les périodes qu’il nomme, dans l’arborescence géographique (nodes, regions, places, periods) ; la branche non géographique de l’arborescence (geo.nongeo) n’est jamais un lieu. |
/api/v1/mentions?term=CRISPR | Les articles qui mentionnent un sujet sans créer de lien vers son article ; complete: false signifie que la liste des articles pointant vers lui a été tronquée. |
/api/v1/reconcile | Un point d’accès Reconciliation Service API 0.2 : le manifeste, queries par lots (GET ou POST), les suggestions d’entités, de types et de propriétés, un aperçu et l’extension des données (title, url, excerpt, topic, topic_path, importance_rank). JSONP avec callback=. Dans OpenRefine : Réconcilier › Démarrer la réconciliation › Ajouter un service standard, puis collez https://www.edgepedia.org/api/v1/reconcile. |
Le graphe de liens, les dates et les listes
Les diagrammes (format=mermaid) sont du texte Mermaid destiné à un environnement qui en assure le rendu.
| Route | Renvoie |
|---|---|
/api/v1/links/{slug} | Les liens de l’article vers d’autres articles, dans l’ordre de lecture, chacun avec son texte d’ancrage et sa phrase. |
/api/v1/backlinks/{slug}?page= | Les articles qui pointent vers lui, à raison de 30 par page, les plus importants en premier, avec leur texte d’ancrage. |
/api/v1/path?from=&to= | La plus courte chaîne de liens entre deux articles (6 sauts au maximum, en évitant autant que possible les nœuds très connectés), avec la phrase qui permet chaque saut. Le serveur MCP l’appelle connect. |
/api/v1/compare?a=&b= | Deux articles côte à côte : introductions, chemins thématiques, thème commun le plus profond, chaîne qui les relie, liens communs et propres à chacun, et tableau des informations essentielles de chacun. |
/api/v1/graph/{slug}?depth=1|2&limit= | Jusqu’à limit de ses voisins les plus importants (50 par défaut, 200 au maximum), et tous les liens entre eux. complete: false (ici, pour les liens entrants et pour rank/top) signifie que le temps alloué à la route, d’environ une seconde, a imposé de tronquer la réponse ; une telle réponse n’est mise en cache que pendant une minute. |
POST /api/v1/context | { "ids": [...] }, jusqu’à 50 identifiants ou adresses (également acceptés par /rank?ids= et /leads?ids=) : les liens entre eux, les articles liés à la plupart d’entre eux, le thème et le lieu communs les plus profonds, et l’introduction de chacun. |
/api/v1/rank?ids=, /api/v1/rank/top?topic=&limit= | L’importance selon PageRank : la somme de pr sur tout le corpus vaut 1, et le rang 1 désigne l’article le plus central. Attention aux noms : importance dans /search et dans les articles correspond à ce rang exprimé en percentile de 0 à 1 ; le importance de /resolve est la valeur brute de pr, et celui de /leads est { pr, rank }. |
/api/v1/timeline?topic=|geo=&from=&to= | Les phrases datées des articles d’un thème ou d’un lieu, des plus anciennes aux plus récentes, à raison de 50 par page ; les années avant notre ère sont négatives. Un nœud conserve au maximum 200 événements répartis sur ses dates, et from et to filtrent cet échantillon ; une réponse tirée d’un échantillon ayant atteint cette limite indique sampled: true et son cap, et son total dénombre les éléments de l’échantillon. |
/api/v1/onthisday?date=MM-DD, /api/v1/year/{year} | Les événements d’un jour de l’année (aujourd’hui en UTC par défaut), ou d’une année donnée (de -9999 à 2100). Un jour contient au maximum 500 événements et une année 2 000 ; lorsque cette limite est atteinte, la réponse indique sampled: true. |
/api/v1/featured?date=, /api/v1/featured.xml | L’article du jour mis à l’honneur (le « Fait du jour » de la page d’accueil), et un flux Atom couvrant les dix derniers jours. |
/api/v1/list?topic=|geo=&period=&type=person | Les articles d’un thème, ou d’un lieu et d’une période (TBC, T500, T1000, T1800, T1946, T2001, T2021, NODATE), à raison de 30 par page ; type=person ne conserve que les personnes. Les lignes d’une liste géographique comprennent geo, mais pas id (récupérez l’article pour l’obtenir). |
/api/v1/keyterms?topic=|geo=&limit= | Les titres et les autres noms d’une sous-arborescence, pour préparer un système de reconnaissance vocale. |
/api/v1/stats?topic=|geo=&by=period | Uniquement des décomptes : articles, liens et autres noms pour le corpus ou pour un nœud et ses nœuds enfants. Ici, articles compte les articles distincts ; dans /geo et /trees/geo, il compte les emplacements : un article présent dans deux périodes d’une région y compte donc deux fois. |
Découverte et autres protocoles
- Fiche du serveur MCP : /.well-known/mcp/server-card.json (également
/mcp/server-card) : nom, point d’accès, outils et versions, sans se connecter. Configuration du registre :/.well-known/mcp/config-schema.jsonet/.well-known/mcp/examples.json. - Catalogue IA : /.well-known/ai-catalog.json : tous les moyens d’accès (MCP, cette API, A2A, NLWeb et l’Agent Skill), avec des exemples de requêtes.
- Catalogue des API : /.well-known/api-catalog, un ensemble de liens conforme à la RFC 9727 qui désigne cette API, sa description et la présente documentation.
- Agent Skill : /.well-known/agent-skills/index.json répertorie
SKILL.mdavec son empreinte sha256. - OpenSearch : /opensearch.xml ajoute Edgepedia comme moteur de recherche.
- A2A :
https://www.edgepedia.org/a2a(JSON-RPC ; A2A 1.0SendMessageet 0.3message/send; fiche à l’adresse/.well-known/agent-card.json). Le nom d’un sujet renvoie les cinq premiers articles ; l’adresse d’un article renvoie celui-ci en Markdown, avec sa mention de la source. La réponse est toujours un message, jamais une tâche, et les mêmes méthodes sont prises en charge sur/mcp. - NLWeb :
https://www.edgepedia.org/ask?query=Mount%20Fuji(GET, ou POST avec un corps JSON ou de formulaire) répond sous forme de liste au format NLWeb, avec unschema_objectschema.org par résultat ;streaming=truetransmet la liste sous forme d’événements envoyés par le serveur. Aucun modèle n’est appelé. - Représentations d’un article lisibles par machine : son adresse renvoie la représentation désignée par un en-tête
Accept:text/markdown(avec une estimationx-markdown-tokens),application/json(la réponse de cette API) ouapplication/ld+json; toute autre valeur renvoie la page. Les pages d’articles comportent un en-têteLinkqui désigne ces représentations, la licence, le catalogue des API et la description OpenAPI.
Fichiers générés
Produits à partir de /openapi.json : ils restent donc toujours conformes à ce fichier.
| Fichier | Description |
|---|---|
| /openapi-3.0.json | La même description en OpenAPI 3.0.3, pour les outils qui ne lisent pas la version 3.1. |
| /arazzo.json | Un flux de travail Arazzo 1.0 : lancer une recherche, récupérer la meilleure correspondance, puis les articles associés. |
| /tools.json | Chaque route JSON sous forme de fonction qu’un modèle peut appeler, aux formats OpenAI, Anthropic et Gemini, ainsi qu’en JSON Schema avec sa route. |
| /edgepedia.d.ts | Les types TypeScript de chaque réponse et des paramètres de chaque route. |
| /edgepedia.postman_collection.json, /edgepedia.bruno.json, /edgepedia.insomnia.json, /edgepedia.http | Un exemple de requête par route pour Postman, Bruno, Insomnia et VS Code ou JetBrains. |
Veuillez envoyer un User-Agent qui indique le nom de votre programme, comme le font les collections (edgepedia-collection/1).