Ottieni una API key di Notion come token di connessione interna o token di accesso personale, condividi le pagine, imposta l'header Notion-Version e invia una prima richiesta.
Una API key di Notion è il token che il tuo codice invia all'API di Notion. Crea una connessione interna nel Developer portal di Notion e copia il suo API token dalla scheda Configuration, poi condividi ogni pagina con la connessione. Ogni richiesta ha bisogno di quel token come valore Bearer più un header Notion-Version.
Le basi dell'API di Notion (developers.notion.com, ottobre 2026)
Collegare Notion al tuo sito, a un modulo o a un agente parte da un solo token. Notion offre due modi per ottenerlo: una connessione interna, che vede solo le pagine che condividi con lei, e un token di accesso personale, che agisce come te. Incolla qui sotto il link di una pagina e questa pagina crea una richiesta pronta da eseguire, con il token lasciato come segnaposto.
Per una connessione interna, aprila nel Developer portal e cerca l'API token nella scheda Configuration. Un token di accesso personale viene mostrato una sola volta quando lo crei, quindi copialo subito.
Una connessione interna è legata a un solo workspace e raggiunge solo le pagine condivise con lei, il che si adatta a un sito o a un'automazione. Un token di accesso personale si autentica come te. Le connessioni pubbliche usano invece OAuth, per app che altri workspace installano.
Notion richiede che ogni pagina sia condivisa manualmente con la connessione prima che possa leggerla o scriverla. Usa Aggiungi connessioni dal menu ••• della pagina, poi riprova.
A ottobre 2026, Notion indica 180 richieste al minuto (circa 3 al secondo) sulla maggior parte dei piani e 600 al minuto su Business ed Enterprise. Le richieste in eccesso ricevono HTTP 429 con il codice rate_limited.
La pagina di Notion sul versioning indica 2026-03-11 come versione più recente. L'header è obbligatorio in tutte le richieste all'API REST; l'SDK ufficiale lo imposta per te.
Imposta il token una volta nel terminale, poi chiama l'endpoint di ricerca. Senza query restituisce tutte le pagine condivise con la connessione.
Sostituisci il segnaposto con il tuo token reale solo nel tuo terminale, mai in un file che committi.
Una semplice fetch da un server o da una funzione serverless, con una breve attesa sul 429.
Incolla il link o l'ID di una pagina Notion e scegli cosa fare. La richiesta usa $NOTION_API_KEY, quindi imposta prima quella variabile nel terminale. Nulla lascia il tuo browser.
Richiesta
Leggi le proprietà della pagina
Leggi i blocchi di contenuto della pagina
Cerca le pagine condivise per titolo
Link o ID della pagina Notion
Parole da cercare
ID della pagina: {v}
Nessun ID di pagina da 32 caratteri trovato ancora in quel testo.
Copia richiesta
Copiato
Inizia gratis · Nessuna carta di credito richiesta