Notion

In dieser Anleitung lernst du Schritt für Schritt, wie du eine Notion API-Integration erstellst, Zugriff auf eine Datenbank gewährst und anschließend Abfragen über die REST API durchführst. Diese Schritte sind notwendig, wenn du Inhalte automatisiert aus Notion lesen, schreiben oder synchronisieren möchtest.

---

🔐 Schritt 1: API-Integration & Secret erstellen (API-Key)

1. Notion öffnen und einloggen

• Gehe zu https://www.notion.so/my-integrations und logge dich in deinem Account ein.

2. Neue Integration erstellen

• Klicke auf „+ New integration“.

• Fülle die Felder wie folgt aus:

  • Name: z. B. Meine API-Anbindung

  • Workspace: Ziel-Workspace auswählen

  • Berechtigungen: Aktiviere gewünschte Berechtigungen (z. B. Read content, Insert content, etc.)

• Klicke auf Submit, um die Integration zu erstellen.

3. API-Key (Secret) kopieren

• Nach dem Erstellen wird dir dein Internal Integration Token angezeigt.

• Kopiere diesen Secret Key – er wird in jeder API-Anfrage im Header benötigt.

Dein Integration Token ist wie ein Passwort. Bewahre ihn sicher auf und teile ihn nicht öffentlich. Ein Verlust oder Leck kann zu ungewolltem Datenzugriff führen.

---

📋 Schritt 2: Zugriff auf eine Datenbank freigeben

1. Öffne in Notion die Datenbank, auf die du über die API zugreifen möchtest.

2. Klicke oben rechts auf „Share“ (Teilen).

3. Wähle „Invite“ (Einladen) und lade deine Integration ein – sie erscheint unter dem Namen, den du im vorherigen Schritt vergeben hast.

4. Weise passende Berechtigungen zu, z. B.:

   • Can read → Nur lesen

   • Can edit → Lesen und Schreiben

Ohne das Teilen der Datenbank mit deiner Integration hat dein Token keinen Zugriff auf die Inhalte! Überprüfe im Zweifel, ob die Integration korrekt eingeladen wurde.

---

🌐 Schritt 3: Abfrage mit der Notion API

Voraussetzungen

• Dein Integration Token (Secret Key)

• Die Datenbank-ID, die in der URL deiner Datenbank enthalten ist (z. B. https://www.notion.so/username/DATENBANK_ID)

---

Beispiel mit cURL

curl -X POST 'https://api.notion.com/v1/databases/DATENBANK_ID/query' \
  -H 'Authorization: Bearer DEIN_SECRET_KEY' \
  -H 'Notion-Version: 2022-06-28' \
  -H 'Content-Type: application/json'

---

Beispiel mit Python

import requests

secret = "DEIN_SECRET_KEY"
database_id = "DEINE_DATENBANK_ID"

url = f"https://api.notion.com/v1/databases/{database_id}/query"
headers = {
    "Authorization": f"Bearer {secret}",
    "Notion-Version": "2022-06-28",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Fehler: {response.status_code} - {response.text}")

Bei größeren Datenbanken liefert Notion die Ergebnisse paginierte zurück. Über das Feld "next_cursor" kannst du die nächsten Seiten abrufen.

---

🔍 Optional: Abfragen mit Filter

Um gezielte Ergebnisse zu erhalten, kannst du Filter definieren.

Beispiel: Nur Einträge mit Titel „Projekt A“

{
  "filter": {
    "property": "Name",
    "rich_text": { "equals": "Projekt A" }
  }
}

Sende diesen JSON-Body mit: requests.post(url, headers=headers, json=DEIN_FILTER)

Filter können nach Text, Checkbox, Datum, Zahl oder Relation gesetzt werden – abhängig vom Feldtyp in deiner Datenbank.

---

📚 Weitere Ressourcen

• Offizielle API-Dokumentation: https://developers.notion.com/

• API-Explorer mit Beispielen: https://developers.notion.com/reference

Nach erfolgreicher Einrichtung kannst du jetzt automatisiert auf deine Notion-Daten zugreifen und eigene Anwendungen oder Skripte integrieren!