Die Pinterest API v5 erstellt Pins für Sie, einschließlich Video-Pins, aber erst, nachdem Ihre App ein Review besteht. Bis dahin sitzt Ihre App im Trial-Zugriff, wo jeder Pin und jedes Board, das sie erstellt, eine Sandbox-Entität ist, die nur für ihren Ersteller sichtbar ist. Diese eine Tatsache entscheidet, ob die API für Sie nützlich ist, deshalb gehört sie ganz nach oben statt in einen Abschnitt über Berechtigungen vergraben.
Was kann die Pinterest-API tatsächlich veröffentlichen?
Sie erstellt Pins auf Boards, die dem authentifizierten Konto gehören: Bild-Pins und Video-Pins, mit Titel, Beschreibung und Ziel-Link. Es ist eine Publishing-API, keine Browsing-API, und sie ist auf Konten beschränkt, die Ihre App autorisiert haben.
Die Lücken, die für eine Bewertung wichtig sind:
| Einschränkung | Was das für Sie bedeutet |
|---|---|
| Trial-Zugriff ist die Standardstufe | Pins und Boards, die Ihre App erstellt, sind Sandbox-Entitäten, nur für ihren Ersteller sichtbar |
| Standardzugriff erfordert Review | Sie reichen eine Videoaufnahme Ihrer App bei der Nutzung der API ein, einschließlich des OAuth-Ablaufs |
| Video-Pins benötigen einen separaten Upload-Schritt | Video-Bytes durchlaufen eine Medienregistrierung und einen Upload-Ablauf vor dem Pin-Aufruf |
| Ratenlimits unterscheiden sich je Stufe | Trial wird pro Tag pro App gemessen, Standard pro Minute pro Nutzer pro App |
Ein internes Tool, das Sie für Ihr eigenes Konto nutzen, kann also unbegrenzt im Trial-Zugriff bleiben. Ein Produkt, das im Namen von Kunden veröffentlicht, kann das nicht, weil Trial-Pins nie sichtbar werden.
Hinweis: Zahlen hier wurden anhand von developers.pinterest.com mit Stand September 2026 überprüft. Plattformen ändern diese ohne Vorankündigung.
Was verlangt der Pinterest-App-Review, und wie lange dauert er?
Sie registrieren eine App, erhalten die Genehmigung für Trial-Zugriff, und beantragen dann das Upgrade auf Standardzugriff. Die Dokumentation von Pinterest besagt, dass das Upgrade voraussetzt, dass Ihre App bereits die Trial-Genehmigung hat, die Entwicklerrichtlinien einhält, und dass Sie eine Videoaufnahme Ihrer App bereitstellen, die eine Aktion über die Pinterest-API abschließt, wobei der Nutzer-Authentifizierungsablauf in der Aufnahme sichtbar sein muss. Bildschirmaufnahmen von Terminal-Aufrufen oder Postman werden als Formate akzeptiert.
Der häufigste Ablehnungsgrund, den Pinterest nennt, ist eine Demo, die den OAuth-Ablauf nicht zeigt, oder die keine echte Pinterest-Integration innerhalb der Anwendung zeigt.
Zur Dauer: Pinterest sagt, dass Standard-Upgrade-Anfragen „regelmäßig überprüft“ werden und Sie per E-Mail benachrichtigt werden, sobald eine Entscheidung getroffen wurde. Es wird vorgeschlagen, ein paar Tage einzuplanen. Es wird keine konkrete Bearbeitungszeit veröffentlicht, behandeln Sie also jede genaue Zahl, die Sie anderswo lesen, als Vermutung. Planen Sie Ihr Launch-Datum um eine Unbekannte herum, nicht um eine versprochene SLA.
Das Auth-Modell selbst ist gewöhnliches OAuth 2.0: Leiten Sie den Nutzer zu Pinterest um, tauschen Sie den Code gegen ein Zugriffstoken und ein Refresh-Token, speichern Sie beide pro Konto, aktualisieren Sie vor Ablauf. Nichts Exotisches. Das Exotische ist die Review-Hürde davor.
Was ist die tatsächliche Sequenz zum Erstellen eines Pins?
Für einen Bild-Pin aus einer öffentlichen URL ist es ein einziger Aufruf. Für einen Video-Pin sind es vier Schritte, weil die Bytes registriert, hochgeladen und verarbeitet werden müssen, bevor ein Pin darauf verweisen kann.
- Den Medien-Upload registrieren.
POST /v5/mediamit dem Medientyp. Die Antwort enthält eine Medien-ID, eine Upload-URL und eine Reihe von Formularparametern. - Die Bytes hochladen.
POSTeines mehrteiligen Formulars an diese Upload-URL, wobei die zurückgegebenen Parameter zuerst als Formularfelder und die Datei zuletzt gesendet werden. Dies ist ein S3-artiger vorsignierter Formular-Post, kein Pinterest-Endpunkt, daher sind seine Fehlerantworten XML statt JSON. - Den Medienstatus abfragen. Den Medieneintrag zurücklesen, bis die Verarbeitung erfolgreich war. Dass der Upload einen 2xx-Status zurückgibt, bedeutet nicht, dass das Video verwendbar ist.
- Den Pin erstellen.
POST /v5/pinsunter Bezug auf das verarbeitete Medium, plus Board, Titel, Beschreibung und Link.
# 1. register
curl -X POST https://api.pinterest.com/v5/media \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"media_type":"video"}'
# 2. upload the bytes to the returned upload_url,
# sending every returned upload parameter as a form field first
curl -X POST "$UPLOAD_URL" \
-F key="$KEY" -F policy="$POLICY" -F "x-amz-signature=$SIG" \
-F file=@clip.mp4
# 3. poll until the media reports a succeeded status
# 4. create the pin referencing that media idHinweis: Wir konnten die genauen Anfrage- und Antwortfeldnamen für
POST /v5/mediaoderPOST /v5/pinsnicht anhand der offiziellen Pinterest-API-Referenz überprüfen: Diese Seiten rendern ihren Inhalt clientseitig und lieferten beim Abruf keinen Dokumentationstext. Lesen Sie die aktuelle API-Referenz auf developers.pinterest.com, bevor Sie dagegen entwickeln, und betrachten Sie die oben genannten Feldnamen als die Form des Ablaufs, nicht als kopierbares Schema.
Der Schritt, den Leute überspringen, ist der dritte. Ein Video-Pin braucht außerdem ein Titelbild, was ein zweites Asset ist, das erzeugt und validiert werden muss. Wir konnten die genaue Titelbild-Anforderung nicht auf einer abrufbaren v5-Referenzseite bestätigen, überprüfen Sie sie also anhand der aktuellen Dokumentation, bevor Sie darauf aufbauen. Wenn Sie Bilder für einen der beiden Pin-Typen dimensionieren, hat unser Leitfaden Pinterest-Pin-Größen die aktuellen Abmessungen.
Was sind die Pinterest-API-Ratenlimits?
Die veröffentlichten Limits unterscheiden sich stark je nach Stufe, was ein weiterer Grund ist, warum Trial-Zugriff keine Vorschau auf das Produktionsverhalten ist.
| Stufe | Dokumentiertes Limit |
|---|---|
| Trial | 1.000 Anfragen pro Tag für alle API-Anfragen, angewendet pro App |
| Standard | 100 Anfragen pro Sekunde pro Nutzer pro App für alle API-Anfragen |
Einzelne Endpunkt-Kategorien haben ihre eigenen engeren Limits zusätzlich zum universellen: Lesen, Schreiben, Analysen und Konversionen haben jeweils ihre eigenen Budgets, und Pinterests eigene Dokumentation weist darauf hin, dass alle Ratenlimits ohne Vorankündigung geändert werden können. Prüfen Sie die Kategorie, die jedem von Ihnen aufgerufenen Endpunkt zugewiesen ist, statt anzunehmen, dass die universelle Zahl gilt.
Hinweis: Zahlen hier wurden anhand von developers.pinterest.com mit Stand September 2026 überprüft. Plattformen ändern diese ohne Vorankündigung.
Was Sie tatsächlich drei Wochen kosten wird
Nicht der Pin-Aufruf. Der Pin-Aufruf ist ein Nachmittag. Die drei Wochen liegen hier:
- Das Review. Sie können nicht mit Trial-Zugriff an Kunden ausliefern, und es gibt keine veröffentlichte Bearbeitungszeit. Reichen Sie früh ein, und reichen Sie eine Aufnahme ein, die den OAuth-Ablauf klar zeigt, denn das ist der genannte Fehlermodus.
- Token-Erneuerung. Refresh-Tokens laufen ab, und Widerrufe passieren lautlos. Sie brauchen ein gespeichertes Refresh-Token pro verbundenem Konto, einen Job, der vor Ablauf erneuert, und einen „Konto erneut verbinden“-Status in Ihrer Oberfläche. Das erst nach dem Ausfall des ersten Kunden-Tokens zu bauen, ist die teure Reihenfolge.
- Medien-Transcodierung. Video-Pins bedeuten, alles zu akzeptieren, was ein Nutzer hochlädt, Codec und Container zu normalisieren, ein Titelbild zu erzeugen und das Ergebnis irgendwo zu speichern, von wo der Upload-Schritt es streamen kann. Das ist eine Medienpipeline, keine API-Integration.
- Asynchrone Fehlerbehandlung. Ein 2xx vom vorsignierten Upload bedeutet, dass die Bytes angekommen sind. Es bedeutet nicht, dass das Video verarbeitet wurde, und es bedeutet nicht, dass ein Pin existiert. Sie brauchen einen Status-Poller, eine Wiederholungsrichtlinie, die zwischen vorübergehenden und dauerhaften Fehlern unterscheidet, und einen Beitragsstatus, der
processingstatt nur veröffentlicht oder fehlgeschlagen sein kann. Wir haben über dieses Zustandsmodell im Leitfaden zur Social-Media-Scheduling-API geschrieben.
Multiplizieren Sie all das mit jeder Plattform, die Sie hinzufügen. Das ist die tatsächliche Form des Aufwands. Der Vergleich Bauen vs. Kaufen setzt Zahlen dazu.
Die Kurzfassung
- Trial-Zugriff ist der Standard und erzeugt Sandbox-Pins, die nur für ihren Ersteller sichtbar sind. Standardzugriff erfordert ein Review mit einer Videodemo des OAuth-Ablaufs. Es wird keine Bearbeitungszeit veröffentlicht.
- Bild-Pins aus einer öffentlichen URL sind ein einziger Aufruf. Video-Pins sind Registrieren, Hochladen, Abfragen, Erstellen, plus ein Titelbild.
- Trial ist auf 1.000 Anfragen pro Tag pro App begrenzt. Standard sind 100 Anfragen pro Sekunde pro Nutzer pro App, mit engeren Limits pro Kategorie darunter.
- Der Entwicklungsaufwand liegt bei Review, Token-Erneuerung, Transcodierung und asynchroner Fehlerbehandlung, nicht beim Veröffentlichungsaufruf.
Das einmal statt pro Plattform tun
Wenn Pinterest eines von mehreren Netzwerken ist, die Sie brauchen, wiederholt sich der Aufwand pro Plattform oben mit jeweils unterschiedlichen Formen: unterschiedliche Review-Hürden, unterschiedliche Medienabläufe, unterschiedliche Kontingentmodelle. Genau das soll unsere API abfangen. BulkPublish veröffentlicht auf 15 Plattformen über einen REST-Endpunkt und ein Beitragsmodell, mit OAuth, Token-Erneuerung, Medienverarbeitung und asynchroner Statusverfolgung auf unserer Seite.
Die Entwicklerdokumentation und die REST-API-Integrationsseite decken die Endpunkte und den Beitragslebenszyklus ab. Wenn Sie Pins lieber über eine Oberfläche als durch das Schreiben gegen eine der beiden APIs planen möchten, deckt Wie man Pinterest-Pins plant diesen Weg ab, und der kostenlose Pinterest-Zeichenzähler hält Ihre Titel und Beschreibungen innerhalb der Limits.