> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Pinterest API > Optionen zum Posten mit der Pinterest API ## 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](/media-guidelines/pinterest) und [Pinterest-Autorisierung](/dashboard/connect-social-accounts/pinterest). ```json Pinterest Post theme={"system"} { "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string "platforms": ["pinterest"], "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"] } ``` ## Pinterest-Optionen Sie können zusätzliche Optionen für einen Beitrag über den Parameter `pinterestOptions` festlegen. ```json Pinterest Post theme={"system"} { "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string "platforms": ["pinterest"], "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"], "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"], // maximum 500 characters "boardId": "93383204522", "carouselOptions": [ { "title": "Image 1", "link": "https://www.cnn.com", "description": "Super Image 1" }, { "title": "Image 2", "link": "https://www.google.com", "description": "Super Image 2" } ], "link": "https://www.ayrshare.com", // maximum 2048 characters "note": "Private note", // maximum 1000 characters "thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg", "title": "A Pinterest Board for You" // maximum 100 characters } } ``` Pinterest-Optionen sind optionale Felder, mit denen sich der Beitrag steuern lässt. Der Alternativtext für Bilder und Videos zur Barrierefreiheit und für Screenreader. Maximal 500 Zeichen. Weitere Informationen finden Sie unter [Pinterest-Alternativtext](/apis/post/social-networks/pinterest#alternative-text). 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](/apis/post/social-networks/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](/apis/post/social-networks/pinterest#pinterest-image-carousel). 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](/apis/post/social-networks/pinterest#pin-link). 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](/apis/post/social-networks/pinterest#pin-note). 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)](/apis/post/social-networks/pinterest#video-pin-thumbnail). Der Titel des Pins, der im Abschnitt „Add your title" angezeigt wird. Maximal 100 Zeichen. Weitere Informationen finden Sie unter [Pin-Titel](/apis/post/social-networks/pinterest#pin-title). \*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](/media-guidelines/pinterest). ## 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`. ```json Pinterest Alt Text theme={"system"} { "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"] } } ``` 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](/apis/user/pinterest-board) erhaltene ID angeben. Andernfalls wird auf dem standardmäßig verknüpften Board gepostet. Verwenden Sie `boardId` im Objekt `pinterestOptions`. ```json Pinterest Board ID theme={"system"} { "pinterestOptions": { "boardId": "93383204522" } } ``` ## Zeichenbeschränkungen Weitere Informationen finden Sie unter [Pinterest-Zeichenbeschränkungen](/help-center/technical-support/character_limits#pinterest-character-limits). ## Pin-Link 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`. ```json Pin Link theme={"system"} { "pinterestOptions": { "link": "https://www.ayrshare.com" } } ``` ## 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`. ```json Pin Note theme={"system"} { "pinterestOptions": { "note": "Private note for collaborators" } } ``` ## 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. ```json Pinterest Carousel Post theme={"system"} { "post": "Carousel Time", "platforms": ["pinterest"], "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", "https://img.ayrshare.com/random/photo-2.jpg" ], "pinterestOptions": { "carouselOptions": [ // optional { "title": "Image 1", "link": "https://www.cnn.com", "description": "Super Image 1" }, { "title": "Image 2", "link": "https://www.google.com", "description": "Super Image 2" } ] } } ``` 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. ## 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`. ```json Pin Title theme={"system"} { "pinterestOptions": { "title": "A Pinterest Board for You" } } ``` ## Video-Pin (Thumbnail) Ein Video kann als Pin über das Standardfeld `mediaUrls` im [/post-Endpunkt](/apis/post/post) 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](/media-guidelines/pinterest). ```json Video Pin with Thumbnail theme={"system"} { "pinterestOptions": { // required "thumbNail": "https://images.unsplash.com/photo-1513093496871-0a81425386e5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=MnwxNjQ1ODN8MHwxfHJhbmRvbXx8fHx8fHx8fDE2Mzg0ODAzNDA&ixlib=rb-1.2.1&q=80&w=400" } } ``` Zusätzliche Informationen zum [Posten von Pins über die API](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/). Wenn Ihr Video nicht mit einer bekannten Videoendung wie mp4 endet, verwenden Sie den Parameter `isVideo`. Weitere Informationen finden Sie unter [/post-Endpunkt](/apis/post/post).