L'accès : seulement les pages partagées
Une connexion interne ne voit que les pages partagées avec elle : depuis le menu ••• en haut à droite d'une page, Add connections. Sans ce partage, les requêtes de l'API renvoient une erreur. Pour une connexion publique (OAuth), donner accès à une page parente donne accès à ses sous-pages.
Le débit
| Offre | Budget par connexion |
|---|---|
| Business et Enterprise | 600 requêtes par minute (10 par seconde en moyenne) |
| Autres offres | 180 requêtes par minute (3 par seconde en moyenne) |
- L'interrogation d'une source de données a sa propre limite, d'environ 3 requêtes par seconde et par connexion.
- Une limite par espace de travail, partagée entre toutes les connexions, s'ajoute.
- Au-delà, l'API répond par une erreur HTTP 429 avec un en-tête Retry-After à respecter.
Les limites de contenu
- L'API ne prend pas en charge tous les types de blocs : un bloc non pris en charge apparaît avec le type « unsupported ».
- Certains blocs existent en lecture mais ne se créent pas par l'API, comme les aperçus de liens (link_preview), ou ne se modifient pas, comme le contenu des blocs synchronisés.
- Une requête est limitée à 1 000 éléments de bloc et 500 Ko, et un tableau de blocs à 100 éléments.
- Un texte enrichi est limité à 2 000 caractères par élément, une URL à 2 000 caractères.
Corbeille et suppression
- L'API place une page dans la corbeille (in_trash à true) et l'en sort (in_trash à false).
- L'API ne supprime jamais une page définitivement.
- Elle ne peut pas restaurer une page de premier niveau qui n'est pas dans un teamspace : il faut passer par l'application.
Ce qu'en fait une sauvegarde externe
Ces règles valent pour tout outil. CYBBACK adapte son débit aux réponses de l'API, publie un rapport de couverture sur ce que la connexion ne voit pas, et remplace à la restauration un bloc non pris en charge par un encadré qui le signale. Voir la solution Notion.
Questions fréquentes
Quel est le débit de l'API Notion ?
Par connexion : 600 requêtes par minute sur Business et Enterprise, 180 sur les autres offres, avec une limite supplémentaire par espace de travail. Au-delà, l'API répond par une erreur 429.
L'API Notion voit-elle tout l'espace de travail ?
Non. Une connexion ne voit que les pages partagées avec elle.
Aller plus loin
Les outils natifs couvrent les erreurs récentes. Pour garder des versions datées au-delà, restaurables et stockées en Europe ou chez vous, découvrez la sauvegarde CYBBACK.
Sources officielles
Faits vérifiés le 14/11/2026 dans la documentation officielle de l'éditeur :
- Notion Developers: Request limits
- Notion Developers: Authorization
- Notion Developers: Block
- Notion Developers: Trash a page
- Notion Developers: Working with databases
Guide indépendant, non affilié à l'éditeur de Notion. Les noms cités sont des marques de leurs propriétaires. Les interfaces évoluent : en cas de doute, la documentation officielle fait foi.