Zum Hauptinhalt springen

Einen Bild-Pin auf Pinterest posten

Die Pinterest API erfordert, dass im Beitrag ein Bild enthalten ist. Andere Parameter sind optional. Weitere Informationen finden Sie unter Pinterest-Medienrichtlinien und Pinterest-Autorisierung.
Pinterest Post

Pinterest-Optionen

Sie können zusätzliche Optionen für einen Beitrag über den Parameter pinterestOptions festlegen.
Pinterest Post
Pinterest-Optionen sind optionale Felder, mit denen sich der Beitrag steuern lässt.
altText
array of strings
Der Alternativtext für Bilder und Videos zur Barrierefreiheit und für Screenreader. Maximal 500 Zeichen.Weitere Informationen finden Sie unter Pinterest-Alternativtext.
boardId
string
Posten Sie auf einem anderen Pinterest-Board des Nutzers, indem Sie die ID aus dem Endpunkt /user/details angeben.Wenn nicht angegeben, wird auf dem standardmäßig verknüpften Board gepostet.Weitere Informationen finden Sie unter Pinterest-Board-ID.
Fügen Sie bis zu 5 Bilder als Pinterest-Karussell mit optionalen Titeln, Links und Beschreibungen hinzu.Jedes Objekt kann Folgendes enthalten: title, link und description.Weitere Informationen finden Sie unter Pinterest-Bilder-Karussell.
Die Ziel-URL, zu der Nutzer beim Klicken auf das Pin-Bild geleitet werden. Maximal 2048 Zeichen.Erstellt einen anklickbaren Link, der Ihrem Pin zugeordnet ist.Weitere Informationen finden Sie unter Pin-Link.
note
string
Fügen Sie einzelnen Pins private Notizen hinzu, die nur Sie und Board-Mitarbeitende sehen. Maximal 1000 Zeichen.Weitere Informationen finden Sie unter Pin-Notiz.
thumbNail
string
Legen Sie ein Thumbnail für Video-Pins fest. Muss PNG oder JPG sein, die gleichen Abmessungen wie das Video haben und unter 10 MB liegen.Für Video-Pins erforderlich.Weitere Informationen finden Sie unter Video-Pin (Thumbnail).
title
string
Der Titel des Pins, der im Abschnitt „Add your title” angezeigt wird. Maximal 100 Zeichen.Weitere Informationen finden Sie unter Pin-Titel.
*Links im Feld post sind nicht anklickbar. Verwenden Sie das Feld link, um einen anklickbaren Link zum Pin hinzuzufügen. Weitere Informationen finden Sie unter Pinterest-Medienrichtlinien.

Alternativtext

Fügen Sie einem Pinterest-Bild oder -Video einen Alternativtext (Alt-Text) hinzu. Pinterest-Alt-Text ist eine Barrierefreiheitsfunktion für zusätzliche Nutzerinformationen und Screenreader. Verwenden Sie altText im Objekt pinterestOptions.
Pinterest Alt Text
Der Alt-Text ist auf 500 Zeichen begrenzt.

Board-ID

Posten Sie auf einem anderen Pinterest-Board des Nutzers, indem Sie die vom Endpunkt /user/details erhaltene ID angeben. Andernfalls wird auf dem standardmäßig verknüpften Board gepostet. Verwenden Sie boardId im Objekt pinterestOptions.
Pinterest Board ID

Zeichenbeschränkungen

Weitere Informationen finden Sie unter Pinterest-Zeichenbeschränkungen. Die Ziel-URL, zu der Nutzer beim Klicken auf Ihr Pin-Bild geleitet werden. Dadurch entsteht ein anklickbarer Link, der Ihrem Pin zugeordnet ist. Die maximale Länge beträgt 2048 Zeichen. Verwenden Sie link im Objekt pinterestOptions.
Pin Link

Pin-Notiz

Sie können einzelnen Pins auf Ihren Boards private Notizen hinzufügen. Nur Sie und Board-Mitarbeitende können sie sehen. Verwenden Sie note im Objekt pinterestOptions.
Pin Note

Pinterest-Bilder-Karussell

Posten Sie bis zu fünf Bilder als Pinterest-Karussell. Wenn Sie mehr als eine Medien-URL angeben, wird automatisch ein Karussell erstellt. Sie können außerdem optionale Karussell-Parameter hinzufügen. Siehe unten.
Pinterest Carousel Post
Das optionale Feld carouselOptions erwartet ein Array von Objekten. Jedes Karussell-Objekt entspricht dem jeweiligen Media-URL-String, z. B. bezieht sich das erste Karussell-Objekt auf den ersten mediaUrl-String.
  • title: Der Bildtitel.
  • link: Der externe Ziel-Link für das Bild.
  • description: Die Bildbeschreibung.

Pinterest-Erwähnungen

Sie können zwar ein @handle zu einem Pinterest-Beitrag hinzufügen, Pinterest unterstützt aber keine Auflösung von Erwähnungen im Beitragstext. Das @handle bleibt als reiner Text bestehen.

Pin-Titel

Der Titel des Pins, der angezeigt wird. Er erscheint im Abschnitt „Add your title” eines neuen Pins. Maximal 100 Zeichen. Verwenden Sie title im Objekt pinterestOptions.
Pin Title

Video-Pin (Thumbnail)

Ein Video kann als Pin über das Standardfeld mediaUrls im /post-Endpunkt veröffentlicht werden. Zusätzlich muss eine Thumbnail-Bild-URL mit dem Video übergeben werden, die einen gültigen Media-Content-Type wie image/jpeg hat. Siehe Anforderungen.
Video Pin with Thumbnail
Zusätzliche Informationen zum Posten von Pins über die API. Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter isVideo. Weitere Informationen finden Sie unter /post-Endpunkt.