Hol dir einen Notion API Key als internes Verbindungs-Token oder persönliches Zugriffstoken, teile Seiten damit, setze den Notion-Version-Header und sende eine erste Anfrage.
Ein Notion API Key ist das Token, das dein Code an die Notion API sendet. Erstelle im Developer-Portal von Notion eine interne Verbindung, kopiere ihr API-Token aus dem Tab Configuration und teile dann jede Seite mit der Verbindung. Jede Anfrage braucht dieses Token als Bearer-Wert plus einen Notion-Version-Header.
Grundlagen der Notion API (developers.notion.com, Oktober 2026)
Notion mit deiner Website, einem Formular oder einem Agenten zu verbinden, beginnt mit einem einzigen Token. Notion bietet zwei Wege dazu: eine interne Verbindung, die nur Seiten sieht, die du mit ihr teilst, und ein persönliches Zugriffstoken, das als du handelt. Füge unten einen Seitenlink ein, und diese Seite baut dir eine startklare Anfrage dafür, wobei das Token ein Platzhalter bleibt.
Bei einer internen Verbindung öffnest du sie im Developer-Portal und findest das API-Token im Tab Configuration. Ein persönliches Zugriffstoken wird nur einmal beim Erstellen angezeigt, kopiere es also sofort.
Eine interne Verbindung gehört zu einem Workspace und erreicht nur Seiten, die mit ihr geteilt wurden, das passt zu einer Website oder Automatisierung. Ein persönliches Zugriffstoken authentifiziert dich als dich selbst. Öffentliche Verbindungen nutzen stattdessen OAuth, für Apps, die andere Workspaces installieren.
Notion verlangt, dass jede Seite manuell mit der Verbindung geteilt wird, bevor diese sie lesen oder schreiben kann. Nutze Verbindungen hinzufügen im Menü ••• der Seite und versuch es dann erneut.
Stand Oktober 2026 nennt Notion 180 Anfragen pro Minute (etwa 3 pro Sekunde) für die meisten Tarife und 600 pro Minute für Business und Enterprise. Zusätzliche Anfragen bekommen HTTP 429 mit dem Code rate_limited.
Notions Seite zur Versionierung nennt 2026-03-11 als neueste Version. Der Header ist bei allen REST-API-Anfragen erforderlich; das offizielle SDK setzt ihn für dich.
Setze das Token einmal in deinem Terminal und ruf dann den Such-Endpoint auf. Ohne Suchbegriff liefert er jede Seite, die mit der Verbindung geteilt ist.
Ersetze den Platzhalter nur in deinem eigenen Terminal durch dein echtes Token, nie in einer Datei, die du committest.
Einfaches fetch von einem Server oder einer Serverless-Funktion, mit einer simplen Wartezeit bei 429.
Füge einen Notion-Seitenlink oder eine ID ein und wähle, was passieren soll. Die Anfrage nutzt $NOTION_API_KEY, setze diese Variable also zuerst in deinem Terminal. Nichts verlässt deinen Browser.
Anfrage
Eigenschaften der Seite lesen
Inhaltsblöcke der Seite lesen
Geteilte Seiten nach Titel durchsuchen
Notion-Seitenlink oder ID
Suchbegriffe
Seiten-ID: {v}
In diesem Text wurde noch keine 32-stellige Seiten-ID gefunden.
Anfrage kopieren
Kopiert
Kostenlos starten · Keine Kreditkarte nötig