API Notion pour debutants : lire et ecrire dans votre workspace

L’API Notion permet de lire et écrire dans votre workspace via des requêtes HTTP standard. Vous pouvez créer des pages, ajouter des entrées dans des bases de données, et récupérer du contenu programmatiquement. Ce guide donne les bases pour commencer.

Prérequis

• Un compte Notion (gratuit suffisant pour débuter)
• Connaissance de base en JavaScript/Python (les exemples sont en JavaScript)
• Postman ou accès terminal pour tester

Étape 1 : Créer une intégration Notion

1. Allez sur notion.so/my-integrations
2. Cliquez « Nouvelle intégration »
3. Nommez votre intégration
4. Choisissez le workspace cible
5. Définissez les capacités (lecture/écriture/contenu utilisateur)
6. Copiez le Token d’intégration (secret_xxxxx)

[IMAGE: notion-api-integration-creation-guide.jpg | Création d’une intégration Notion API — étapes]

Étape 2 : Connecter l’intégration à une page

Dans Notion : ouvrez la page → Partager → Inviter → sélectionnez votre intégration. Sans cette étape, l’API ne peut pas accéder à la page.

Étape 3 : Premiers appels API

Récupérer les infos d’une page :

const { Client } = require('@notionhq/client');

const notion = new Client({ auth: process.env.NOTION_TOKEN });

async function getPage(pageId) {
  const response = await notion.pages.retrieve({ page_id: pageId });
  console.log(response);
}

getPage('votre-page-id');

Créer une nouvelle entrée dans une base de données :

async function createEntry(databaseId) {
  const response = await notion.pages.create({
    parent: { database_id: databaseId },
    properties: {
      'Titre': {
        title: [{ text: { content: 'Mon nouvel articlé' } }]
      },
      'Statut': {
        select: { name: 'Brouillon' }
      },
      'Date': {
        date: { start: new Date().toISOString() }
      }
    }
  });
  return response;
}

Requêter une base de données avec filtre :

async function queryDatabase(databaseId) {
  const response = await notion.databases.query({
    database_id: databaseId,
    filter: {
      property: 'Statut',
      select: { equals: 'Publié' }
    },
    sorts: [{
      property: 'Date',
      direction: 'descending'
    }]
  });
  return response.results;
}

Cas d’usage populaires avec l’API

1. Exporter Notion vers un site web
Récupérer le contenu de vos pages Notion et le rendre sur un site statique (Next.js, Gatsby). Super.so et des créateurs indépendants ont construit des produits sur cette base.

2. Sync Notion ↔ autre système
Synchroniser une base de données Notion avec Airtable, Google Sheets ou votre propre BDD.

3. Automatiser les rapports
Un script qui tourne chaque soir, récupère des données d’une API externe (GA4, Stripe) et crée une entrée de rapport dans Notion.

4. CMS headless
Utiliser Notion comme back-office pour gérer du contenu publié sur votre site.

Limites de l’API

• Rate limit : 3 requêtes/seconde
• Les blocs enfants imbriqués nécessitent des appels récursifs
• Pas toutes les fonctionnalités Notion sont dans l’API (certains types de blocs)

Lire aussi : Notion zapier automatisations | Notion pour développeurs

Articlés connexes

By Maxime Berger

Maxime Berger est coach en productivité personnelle, auteur de la newsletter 'Focus Flow' suivie par 12 000 abonnés. Ancien ingénieur reconverti, il applique les méthodes GTD, Zettelkasten et Deep Work à sa propre vie et les enseigne à ses clients. Sur guide-productivite.com, il teste en conditions réelles tous les outils de productivité — Notion, Obsidian, Todoist — pour vous donner son avis honnête.

See all articles by Maxime Berger  ·  Last updated: 9 April 2026