Pinterest
BulkPublish
Pinterest API
Veröffentliche, plane und verwalte Pinterest aus deinem eigenen Code. Eine REST-API und ein Schlüssel decken Pinterest und jedes andere verbundene Netzwerk ab, du schreibst die Integration also nur einmal.
Was die Pinterest API abdeckt
Alles unten gehört zur veröffentlichten API und funktioniert heute mit Pinterest.
| Funktion | Endpunkt |
|---|---|
| Beiträge erstellen, planen, bearbeiten und veröffentlichen | POST /api/posts |
| Bilder und Videos hochladen | POST /api/media |
| Den nächsten freien Slot in deiner Warteschlange finden | GET /api/posts/queue-slot |
| Wiederkehrende Pläne anlegen | POST /api/schedules |
| Neue Einträge aus einem RSS-Feed veröffentlichen | POST /api/rss-feeds |
| Pinterest Boards für einen Kanal abrufen | GET /api/channels/{id}/options |
| Kennzahlen pro Beitrag lesen | GET /api/posts/{id}/metrics |
| Prüfen, ob die Verbindung in Ordnung ist | GET /api/channels/{id}/health |
| Die Nutzung deines Tarifs prüfen | GET /api/quotas/usage |
Beitragstypen, die du auf Pinterest veröffentlichen kannst
Wähle den Typ mit postTypeOverrides. Ein Typ, den Pinterest nicht anbietet, wird abgelehnt, bevor etwas eingereiht wird.
| Beitragstyp | Medien |
|---|---|
pin Pin | Erforderlich: 1 Bild |
video_pin Video Pin | Erforderlich: 1 Video |
carousel Carousel | Erforderlich: 2 bis 5 Bilder |
Einen Pinterest-Beitrag mit curl planen
Drei Anfragen: Kanal finden, die Datei hochladen, falls der Beitrag eine hat, dann den Beitrag erstellen. Ersetze den Schlüssel durch einen aus Einstellungen, dann API-Schlüssel, und 12 durch deine eigene Kanal-ID.
1. Liste deine Kanäle auf und notiere die ID deines Pinterest-Kontos.
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. Lade die Datei hoch. Die Antwort enthält die Medien-ID, die unten als mediaFiles verwendet wird.
curl -X POST https://app.bulkpublish.com/api/media \
-H "Authorization: Bearer bp_your_key_here" \
-F "file=@photo.jpg" 3. Erstelle den Beitrag.
curl -X POST https://app.bulkpublish.com/api/posts \
-H "Authorization: Bearer bp_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"content": "A 20 minute pasta for busy evenings",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"mediaFiles": [101],
"platformSpecific": {
"pinterest": {
"12": {
"boardId": "BOARD_ID"
},
"title": "Weeknight pasta",
"link": "https://example.com/pasta"
}
}
}' Die Antwort ist der erstellte Beitrag mit ID und Status. Rufe ihn später mit GET /api/posts/{id} ab, um zu sehen, wie es lief.
Pinterest-Optionen
Sende diese innerhalb von platformSpecific, unter dem Schlüssel für Pinterest.
Bei Pinterest sind die Optionen nach deiner Kanal-ID abgelegt, zum Beispiel "12", oder werden flach gesendet und gelten dann für jeden Pinterest-Kanal des Beitrags.
| Option | Was sie bewirkt | Akzeptiert |
|---|---|---|
title | Titel | Text |
description | Beschreibung | Text |
link | Ziellink | Text |
dominantColor | Hintergrundfarbe des Pins | Text |
coverImageUrl | Titelbild für Video-Pins | Text |
boardId | Board, auf das gepinnt wird | Text |
Die gültigen Boards für einen Kanal findest du mit GET /api/channels/{id}/options.
Pinterest-Analysen über die API
Diese Kennzahlen kommen für jeden Pinterest-Beitrag über GET /api/posts/{id}/metrics zurück, mit Momentaufnahmen im Zeitverlauf.
- Impressionen
- Klicks
- Gespeichert
- Videoaufrufe
- Likes
- Kommentare
- Interaktionsrate
Kommentare und Nachrichten
BulkPublish liest keine Kommentare oder Nachrichten auf Pinterest, hier gibt es also nichts aufzulisten oder zu beantworten.
API-Zugriff in jedem Tarif
Jeder Tarif enthält API-Schlüssel, auch der Free-Tarif. Das erlaubt jeder Stufe.
| Tarif | API-Schlüssel | Anfragen pro Tag |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5.000 |
| Business | 10 | 50.000 |
Direkt auf Pinterest aufbauen oder BulkPublish nutzen
Der direkte Weg ist eine faire Wahl, besonders wenn du etwas brauchst, das BulkPublish nicht anbietet. Das verlangt Pinterest API v5 von dir, geprüft anhand der Dokumentation im Oktober 2026.
- Du registrierst eine Entwickler-App bei Pinterest, bevor du veröffentlichen kannst.
- Zugriffstokens laufen nach etwa 30 Tagen ab, du brauchst also einen eigenen Weg, sie zu erneuern oder die Verbindung neu aufzubauen, bevor sie verfallen.
BulkPublish hält die Verbindung für dich aufrecht: Es erneuert Tokens, prüft jeden Beitrag vor dem Einreihen gegen die Regeln von Pinterest und meldet ein fehlgeschlagenes Ziel am Beitrag, sodass dein Code nur eine Anfrage stellt.
Offizielle Dokumentation lesen
Lieber einen Assistenten fragen?
Claude, ChatGPT und Cursor können dasselbe über den Pinterest-MCP-Server, mit Prompts statt Code.
Den Pinterest-MCP-Server ansehen
Lieber einen Kalender als Code?
Dasselbe Pinterest-Konto lässt sich auch in der App planen, mit Content-Kalender und Massen-Upload.
Häufige Fragen
Häufige Fragen zur Pinterest API.
Gibt es eine Pinterest API, die ich nutzen kann, ohne die Integration selbst zu bauen?
Ja. BulkPublish stellt Pinterest über seine REST-API bereit. Verbinde dein Pinterest-Konto einmal, dann kannst du es mit einem Schlüssel veröffentlichen, planen und verwalten. Derselbe Schlüssel funktioniert für jedes andere verbundene Netzwerk.
Was kann ich über die API auf Pinterest veröffentlichen?
Die Beitragstypen sind Pin, Video Pin und Carousel. Jeder wird vor dem Einreihen gegen die Medienregeln von Pinterest geprüft, eine Anfrage, die Pinterest ablehnen würde, scheitert also sofort mit einer klaren Fehlermeldung.
Kann ich Pinterest-Beiträge über die API planen?
Ja. Sende den Status "scheduled" mit einer scheduledAt-Zeit und einer timezone, oder frage zuerst nach dem nächsten freien Slot in deiner Warteschlange. Wiederkehrende Pläne und RSS-Feeds gibt es ebenfalls.
Kann ich Pinterest-Analysen über die API lesen?
Ja. Zu den Kennzahlen pro Beitrag gehören Impressionen, Klicks, Gespeichert, Videoaufrufe, Likes, Kommentare und Interaktionsrate, mit Momentaufnahmen im Zeitverlauf.
Kann ich Pinterest-Kommentare oder -Nachrichten über die API lesen und beantworten?
Nein. BulkPublish liest keine Kommentare oder Nachrichten auf Pinterest.
Kostet die Pinterest API extra?
Nein. Der API-Zugriff ist in jedem Tarif enthalten. Free umfasst 1 Schlüssel und 30 Anfragen am Tag, Pro 5 Schlüssel und 5.000 am Tag, Business 10 Schlüssel und 50.000 am Tag.
Brauche ich ein Pinterest-Entwicklerkonto oder eine App-Prüfung?
Nicht, um BulkPublish zu nutzen. Du verbindest dein Pinterest-Konto auf der Seite Kanäle und veröffentlichst mit einem BulkPublish-Schlüssel. Wenn du stattdessen auf der eigenen API von Pinterest aufbaust, steht im Abschnitt oben, was sie von dir verlangt.
Kann das auch ein KI-Assistent erledigen?
Ja. Die Seite zum Pinterest-MCP-Server zeigt, wie du Claude, ChatGPT oder Cursor verbindest und was du anfragen kannst.
Weitere Netzwerke
Derselbe Schlüssel und dieselbe Anfrageform funktionieren für 15 Netzwerke.
Per Code auf Pinterest veröffentlichen
Erstelle ein kostenloses Konto, verbinde Pinterest und erzeuge einen Schlüssel. Keine Karte nötig.