Notion API : ouvrir Notion sur l’écosystème digital
L’API Notion transforme Notion d’un simple espace de notes en plateforme de données connectée à l’ensemble de votre stack digital. Formulaires, CRM, outils analytiques, services de messagerie — tout peut interagir avec vos bases de données Notion via l’API officielle. Ce guide s’adresse aux utilisateurs qui veulent aller au-delà des intégrations clés en main et créer leurs propres automatisations sur mesure.
Qu’est-ce que l’API Notion ?
L’API Notion (officiellement lancée en 2021) est une API REST publique qui permet de lire, créer, modifier et supprimer du contenu dans votre workspace Notion de manière programmatique. Elle supporte :
⚡ Les meilleurs outils de productivité en 2026
Découvrez notre sélection des outils qui vont transformer votre organisation : Notion, Todoist, Obsidian et plus.
Voir le classement 2026 →- La lecture et l’écriture dans les bases de données
- La création et la modification de pages
- La récupération du contenu de blocs
- La gestion des utilisateurs et des permissions
- La recherche dans le workspace
L’API est disponible pour tous les plans Notion, y compris le plan gratuit. La limite principale sur le plan gratuit concerne le nombre d’intégrations actives et les rate limits (3 requêtes par seconde).
Créer votre première intégration Notion
Étape 1 : Créer une intégration
Rendez-vous sur notion.so/my-integrations. Cliquez sur «Nouvelle intégration». Donnez-lui un nom évocateur («Mon CRM Automatique», «Sync Formulaire», etc.). Choisissez le workspace associé. Récupérez le token d’intégration — c’est votre clé d’accès secrète.
Étape 2 : Connecter la base de données
Dans votre base Notion cible, cliquez sur les trois points «…» en haut à droite, puis sur «Connexions». Ajoutez votre intégration. Récupérez l’ID de la base de données dans l’URL (la partie après le dernier slash, avant le «?»).
Étape 3 : Premier appel API
En Python avec la librairie officielle :
pip install notion-client
Ensuite dans votre script :
from notion_client import Client
client = Client(auth="votre_token")
results = client.databases.query(database_id="votre_id")
print(results)Vous venez de lire votre première base de données Notion par code.
Les endpoints essentiels de l’API Notion
Lire une base de données
L’endpoint POST /databases/{id}/query retourne les entrées de votre base avec les filtrès et tris que vous spécifiez. Exemple de filtre : retourner uniquement les tâches avec statut «À faire» créées dans les 7 derniers jours.
Créer une page (entrée)
L’endpoint POST /pages crée une nouvelle entrée dans une base. Utile pour alimenter une base Notion depuis un formulaire externe, un webhook ou un autre service.
Modifier une page
PATCH /pages/{id} modifie les propriétés d’une entrée existante. C’est le fondement des automatisations de mise à jour de statut.
Lire le contenu d’une page
GET /blocks/{id}/children retourne les blocs de contenu d’une page. Utile pour extraire le texte d’articlés ou de notes.
Cas d’usage concrets avec Make (Integromat)
Make (ex-Integromat) dispose d’un module Notion natif qui utilise l’API en arrière-plan. Voici des scénarios puissants :
Scénario 1 : Formulaire → Notion
Tally (formulaire) → Make → Notion. Chaque soumission crée une nouvelle entrée dans votre base CRM. Parfait pour la génération de leads, les inscriptions newsletter ou les demandes de contact.
Scénario 2 : Gmail → Notion
Chaque email d’un domaine spécifique (ex. votre banque) crée une entrée dans votre base «Documents financiers» avec expéditeur, sujet, date et lien de pré-visualisation.
Scénario 3 : Notion → Slack
Quand’une entrée change de statut vers «Prêt pour review», une notification’est envoyée dans le canal Slack de votre équipe avec le lien direct vers la page Notion.
Pour en savoir plus sur ces automatisations, consultez notre guide dédié aux automatisations Notion avec Zapier.
Créer une intégration personnalisée en Python
Voici un exemple de script qui synchronise quotidiennement vos tâches Notion avec votre liste de tâches du jour :
from notion_client import Client
from datetime import datetime, timedelta
client = Client(auth="votre_token")
# Tâches dues aujourd'hui
results = client.databases.query(
database_id="votre_db_id",
filter={
"and": [
{"property": "Date", "date": {"equals": datetime.now().date().isoformat()}},
{"property": "Statut", "select": {"does_not_equal": "Terminé"}}
]
}
)
for task in results["results"]:
titre = task["properties"]["Nom"]["title"][0]["plain_text"]
print(f"- {titre}")Ce script peut être exécuté chaque matin via cron sur un serveur ou GitHub Actions pour envoyer votre liste de tâches du jour par email ou Telegram.
Utiliser l’API Notion avec n8n (open source)
n8n’est une alternative open-source à Zapier/Make que vous pouvez héberger vous-même. Elle dispose d’un node Notion complet. Avantage : aucune limite de tâches, données sur votre serveur, personnalisation totale. Idéal pour les utilisateurs techniques qui traitent de gros volumes.
Webhooks entrants dans Notion
L’API Notion ne supporte pas nativement les webhooks sortants (notifications push quand’une page est modifiée). Pour ce besoin, utilisez une solution de polling : interrogez l’API toutes les 5 minutes pour détecter les changements. Ou utilisez des services comme Zapier qui gèrent ce polling de façon transparente.
Pour les relations entre vos bases de données, notre guide sur les bases de données relationnelles vous sera très utile.
Bonnes pratiques sécurité
- Ne jamais exposer votre token d’intégration dans un repo public Git
- Créer des intégrations avec les permissions minimales nécessaires
- Révoquer les tokens inutilisés régulièrement
- Utiliser des variables d’environnement pour stocker les tokens
- Monitorer vos rate limits pour ne pas bloquer vos automatisations
Conclusion : l’API Notion, un écosystème sans limites
L’API Notion ouvre des possibilités presque illimitées pour les utilisateurs qui veulent dépasser les templates pré-construits. Qu’il s’agisse d’alimenter Notion depuis des formulaires, de synchroniser avec d’autrès outils ou de créer des dashboards personnalisés, l’API vous donne le contrôle total. Commencez par un scénario simple (formulaire → base Notion), testez, puis montez en complexité graduellement. Pour les formules avancées dans Notion, consultez également notre guide sur les formules Notion.
A lire aussi
