Consigue una API key de Notion como token de conexión interna o token de acceso personal, comparte páginas con ella, define la cabecera Notion-Version y envía una primera petición.
Una API key de Notion es el token que tu código envía a la API de Notion. Crea una conexión interna en el Developer portal de Notion y copia su API token desde la pestaña Configuration; después comparte cada página con la conexión. Cada petición necesita ese token como valor Bearer más una cabecera Notion-Version.
Conceptos básicos de la API de Notion (developers.notion.com, octubre de 2026)
Conectar Notion con tu web, un formulario o un agente empieza con un token. Notion tiene dos formas de obtenerlo: una conexión interna, que solo ve las páginas que compartes con ella, y un token de acceso personal, que actúa como tú. Pega abajo el enlace de una página y esta página genera una petición lista para ejecutar, con el token como marcador.
En una conexión interna, ábrela en el Developer portal y busca el API token en la pestaña Configuration. Un token de acceso personal se muestra una sola vez al crearlo, así que cópialo enseguida.
Una conexión interna está vinculada a un espacio de trabajo y solo llega a las páginas compartidas con ella, lo que encaja con una web o una automatización. Un token de acceso personal se autentica como tú. Las conexiones públicas usan OAuth en su lugar, para apps que instalan otros espacios de trabajo.
Notion exige compartir manualmente cada página con la conexión antes de que pueda leerla o escribir en ella. Usa Add connections desde el menú ••• de la página y vuelve a intentarlo.
A octubre de 2026, Notion indica 180 peticiones por minuto (unas 3 por segundo) en la mayoría de planes y 600 por minuto en Business y Enterprise. Las peticiones de más reciben HTTP 429 con el código rate_limited.
La página de versiones de Notion indica 2026-03-11 como la versión más reciente. La cabecera es obligatoria en todas las peticiones a la API REST; el SDK oficial la pone por ti.
Define el token una vez en tu terminal y luego llama al endpoint de búsqueda. Sin consulta, devuelve todas las páginas compartidas con la conexión.
Sustituye el marcador por tu token real solo en tu propia terminal, nunca en un archivo que subas al repositorio.
Un fetch sencillo desde un servidor o una función serverless, con una espera simple ante un 429.
Pega un enlace o ID de página de Notion y elige qué hacer. La petición usa $NOTION_API_KEY, así que define primero esa variable en tu terminal. Nada sale de tu navegador.
Petición
Leer las propiedades de la página
Leer los bloques de contenido de la página
Buscar páginas compartidas por título
Enlace o ID de la página de Notion
Palabras de búsqueda
ID de la página: {v}
Aún no se ha encontrado un ID de página de 32 caracteres en ese texto.
Copiar petición
Copiado
Empieza gratis · Sin tarjeta de crédito