Krijg een Notion API-sleutel als token van een interne connectie of als persoonlijk toegangstoken, deel er pagina's mee, stel de Notion-Version-header in en stuur een eerste request.
Een Notion API-sleutel is het token dat uw code naar de Notion API stuurt. Maak een interne connectie aan in het Developer portal van Notion en kopieer het API-token op het tabblad Configuration, en deel daarna elke pagina met de connectie. Elk request heeft dat token nodig als Bearer-waarde plus een Notion-Version-header.
Basis van de Notion API (developers.notion.com, oktober 2026)
Notion koppelen aan uw site, een formulier of een agent begint met één token. Notion biedt twee manieren om het te krijgen: een interne connectie, die alleen pagina's ziet die u ermee deelt, en een persoonlijk toegangstoken, dat namens u handelt. Plak hieronder een paginalink en deze pagina bouwt er een kant-en-klaar request voor, met het token als placeholder.
Voor een interne connectie opent u die in het Developer portal en zoekt u het API-token op het tabblad Configuration. Een persoonlijk toegangstoken wordt één keer getoond als u het aanmaakt, dus kopieer het meteen.
Een interne connectie hoort bij één workspace en bereikt alleen pagina's die ermee gedeeld zijn, wat past bij een site of automatisering. Een persoonlijk toegangstoken authenticeert als u. Publieke connecties gebruiken in plaats daarvan OAuth, voor apps die andere workspaces installeren.
Notion vereist dat elke pagina handmatig met de connectie wordt gedeeld voordat die haar kan lezen of bewerken. Gebruik Add connections in het menu ••• van de pagina en probeer het opnieuw.
Per oktober 2026 noemt Notion 180 requests per minuut (ongeveer 3 per seconde) voor de meeste abonnementen en 600 per minuut voor Business en Enterprise. Extra requests krijgen HTTP 429 met de code rate_limited.
De versiepagina van Notion noemt 2026-03-11 als de nieuwste versie. De header is verplicht bij alle REST API-requests; de officiële SDK stelt hem voor u in.
Stel het token één keer in uw terminal in en roep daarna het search-endpoint aan. Zonder zoekopdracht geeft het elke pagina terug die met de connectie gedeeld is.
Vervang de placeholder alleen in uw eigen terminal door uw echte token, nooit in een bestand dat u commit.
Gewone fetch vanaf een server of serverless function, met eenvoudig wachten bij 429.
Plak een Notion-paginalink of ID en kies wat u wilt doen. Het request gebruikt $NOTION_API_KEY, dus stel die variabele eerst in uw terminal in. Niets verlaat uw browser.
Request
Eigenschappen van de pagina lezen
Inhoudsblokken van de pagina lezen
Gedeelde pagina's op titel zoeken
Notion-paginalink of ID
Zoekwoorden
Pagina-ID: {v}
Nog geen pagina-ID van 32 tekens gevonden in die tekst.
Request kopiëren
Gekopieerd
Gratis beginnen · Geen creditcard nodig