Obtenha uma chave de API do Notion como token de conexão interna ou token de acesso pessoal, compartilhe páginas com ela, defina o header Notion-Version e envie uma primeira requisição.
Uma chave de API do Notion é o token que o seu código envia para a API do Notion. Crie uma conexão interna no Developer portal do Notion e copie o token de API na aba Configuration, depois compartilhe cada página com a conexão. Toda requisição precisa desse token como valor Bearer, mais um header Notion-Version.
Noções básicas da API do Notion (developers.notion.com, outubro de 2026)
Conectar o Notion ao seu site, a um formulário ou a um agente começa com um token. O Notion tem duas formas de obtê-lo: uma conexão interna, que só enxerga as páginas que você compartilha com ela, e um token de acesso pessoal, que age como você. Cole o link de uma página abaixo e esta página monta uma requisição pronta para rodar, com o token mantido como marcador.
Numa conexão interna, abra-a no Developer portal e procure o token de API na aba Configuration. Um token de acesso pessoal é mostrado uma única vez quando você o cria, então copie na hora.
Uma conexão interna fica ligada a um workspace e só alcança as páginas compartilhadas com ela, o que serve para um site ou uma automação. Um token de acesso pessoal autentica como você. Conexões públicas usam OAuth, para apps que outros workspaces instalam.
O Notion exige que cada página seja compartilhada manualmente com a conexão antes que ela possa ler ou gravar nela. Use Adicionar conexões no menu ••• da página e tente de novo.
Em outubro de 2026, o Notion lista 180 requisições por minuto (cerca de 3 por segundo) na maioria dos planos e 600 por minuto no Business e no Enterprise. Requisições extras recebem HTTP 429 com o código rate_limited.
A página de versionamento do Notion indica 2026-03-11 como a versão mais recente. O header é obrigatório em todas as requisições da API REST; o SDK oficial o define para você.
Defina o token uma vez no terminal e depois chame o endpoint de busca. Sem consulta, ele retorna todas as páginas compartilhadas com a conexão.
Troque o marcador pelo seu token real apenas no seu próprio terminal, nunca num arquivo que você commita.
Um fetch simples a partir de um servidor ou função serverless, com uma espera simples no 429.
Cole o link ou o ID de uma página do Notion e escolha o que fazer. A requisição usa $NOTION_API_KEY, então defina essa variável no seu terminal antes. Nada sai do seu navegador.
Requisição
Ler as propriedades da página
Ler os blocos de conteúdo da página
Buscar páginas compartilhadas pelo título
Link ou ID da página do Notion
Palavras de busca
ID da página: {v}
Nenhum ID de página de 32 caracteres encontrado nesse texto ainda.
Copiar requisição
Copiado
Comece grátis · Sem cartão de crédito