Obtenez une clé API Notion sous forme de jeton de connexion interne ou de jeton d'accès personnel, partagez des pages avec elle, définissez l'en-tête Notion-Version et envoyez une première requête.
Une clé API Notion est le jeton que votre code envoie à l'API Notion. Créez une connexion interne dans le Developer portal de Notion et copiez son jeton API dans l'onglet Configuration, puis partagez chaque page avec la connexion. Chaque requête a besoin de ce jeton en valeur Bearer, ainsi que d'un en-tête Notion-Version.
Les bases de l'API Notion (developers.notion.com, octobre 2026)
Connecter Notion à votre site, à un formulaire ou à un agent commence par un seul jeton. Notion propose deux façons de l'obtenir : une connexion interne, qui ne voit que les pages que vous partagez avec elle, et un jeton d'accès personnel, qui agit en votre nom. Collez ci-dessous le lien d'une page et cette page construit une requête prête à l'emploi, avec le jeton laissé en valeur d'exemple.
Pour une connexion interne, ouvrez-la dans le Developer portal et cherchez le jeton API dans l'onglet Configuration. Un jeton d'accès personnel n'est affiché qu'une fois, à sa création, copiez-le donc immédiatement.
Une connexion interne est liée à un seul espace de travail et n'atteint que les pages partagées avec elle, ce qui convient à un site ou une automatisation. Un jeton d'accès personnel vous authentifie, vous. Les connexions publiques utilisent OAuth à la place, pour les applications que d'autres espaces de travail installent.
Notion exige que chaque page soit partagée manuellement avec la connexion avant qu'elle puisse la lire ou la modifier. Utilisez Ajouter des connexions dans le menu ••• de la page, puis réessayez.
En octobre 2026, Notion indique 180 requêtes par minute (environ 3 par seconde) sur la plupart des forfaits et 600 par minute sur Business et Enterprise. Les requêtes en trop reçoivent un HTTP 429 avec le code rate_limited.
La page de versionnage de Notion indique 2026-03-11 comme version la plus récente. L'en-tête est obligatoire sur toutes les requêtes de l'API REST ; le SDK officiel le définit pour vous.
Définissez le jeton une fois dans votre terminal, puis appelez l'endpoint search. Sans requête de recherche, il renvoie toutes les pages partagées avec la connexion.
Remplacez la valeur d'exemple par votre vrai jeton uniquement dans votre propre terminal, jamais dans un fichier que vous commitez.
Un simple fetch depuis un serveur ou une fonction serverless, avec une attente basique sur 429.
Collez le lien ou l'ID d'une page Notion et choisissez l'action. La requête utilise $NOTION_API_KEY, définissez donc d'abord cette variable dans votre terminal. Rien ne quitte votre navigateur.
Requête
Lire les propriétés de la page
Lire les blocs de contenu de la page
Rechercher les pages partagées par titre
Lien ou ID de la page Notion
Mots à rechercher
ID de la page : {v}
Aucun ID de page de 32 caractères trouvé dans ce texte pour l'instant.
Copier la requête
Copié
Commencer gratuitement · Sans carte bancaire