EN BREF

EN BREF

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 article' } }]
      },
      '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

Articles connexes

A propos de l'auteur

Maxime Berger

Coach en productivite et specialiste Notion

Maxime Berger est coach en productivite et consultant Notion certifie depuis 7 ans. Ancien Product Manager chez Alan, il a forme plus de 500 professionnels aux methodes de travail efficaces. Il partage templates et strategies sur guide-productivite.com.

400 articles publiésVoir le profil →