Wie Pinterest-Alt-Text an Pins und in der API funktioniert

Was ist Pinterest-Alt-Text?

Wer Pinterest-Alt-Text schreibt, füllt das Feld alt_text an einem Pin aus, eine Beschreibung des Bildes in reinem Text, die Screenreader für Menschen vorlesen, die es nicht sehen können. Das Feld gehört zum Pin, neben Titel, Beschreibung und Link, und die Pinterest API gibt es bei jedem Pin zurück, den sie ausliest.

Alt-Text und Pin-Beschreibung haben verschiedene Aufgaben. Die Beschreibung ist Text für Menschen, die stöbern, und für das Ranking von Pinterest: Die Seite mit den Produktspezifikationen von Pinterest sagt „Descriptions are used by our algorithm to determine relevance for delivery.“ Alt-Text beschreibt, was das Bild zeigt, für Menschen mit Hilfstechnologien. Eine für Suchende geschriebene Beschreibung wie „schnelle Feierabend-Pasta, 20 Minuten“ sagt einer Person mit Screenreader nichts über das Bild. Alt-Text für denselben Pin lautet „eine Schüssel Spaghetti mit Tomatensoße und Basilikum auf einem Holztisch“.

Die beiden haben auch getrennte Limits, wer das eine schreibt, verbraucht also keinen Platz im anderen.

Wie hoch ist das Zeichenlimit für Pinterest-Alt-Text?

Das Zeichenlimit für Pinterest-Alt-Text liegt bei 500 Zeichen, festgelegt für das Feld alt_text in der Referenz der Pinterest API zum Erstellen und Aktualisieren eines Pins. So sieht es im Vergleich zu den anderen Textfeldern eines Pins aus:

Die Entwicklerdokumentation markiert alt_text als „Nullable“, ein Pin ohne Alt-Text ist also gültig und kommt mit "alt_text": null zurück. Die Zahl von 500 Zeichen stammt aus der API-Referenz. Die Hilfe von Pinterest veröffentlicht keine eigene Zahl für Alt-Text, behandle 500 also als Obergrenze für jedes Tool, das in die API schreibt.

Wie fügst du einem Pin Alt-Text hinzu?

Du fügst einem Pin Alt-Text über das Feld alt_text hinzu, wenn der Pin erstellt oder aktualisiert wird, und genau diesen Weg dokumentiert Pinterest für Entwickler und für Tools, die auf seiner API aufbauen. Für die Pinterest-Website und -App listet der Hilfeartikel „Create a Pin from an image or video“ als auszufüllende Felder Titel, Beschreibung, Link, Pinnwand, verwandte Themen, späteres Veröffentlichen, die Schalter für KI-bearbeitete Inhalte und „More options“ für Kommentare und Shopping-Empfehlungen. Alt-Text steht nicht auf dieser Liste. Der Artikel „Edit or delete a Pin“ listet Titel, Beschreibung, Link, Pinnwand und Kommentareinstellungen, auch dort ohne Alt-Text.

Damit bleiben zwei Wege, die Pinterest vollständig dokumentiert:

1. Den Pin mit Alt-Text erstellen. Sende POST /v5/pins mit alt_text im Request-Body, neben board_id, title, description und media_source.
2. Ihn später hinzufügen oder ändern. Sende PATCH /v5/pins/{pin_id} mit einem neuen alt_text. Das Update-Schema hat dasselbe Limit von 500 Zeichen.

Zeigt dein eigener Pin-Editor ein Alt-Text-Feld, nutze es genauso und bleib innerhalb von 500 Zeichen, damit der Text zu dem passt, was die API annimmt. Den restlichen Ablauf beim Erstellen eines Pins, von Pinnwänden bis zu Bildformaten, erklärt wie du Bilder auf Pinterest postest.

Wohin gehört alt_text in einer Anfrage an die Pinterest API?

alt_text steht in der Pinterest API auf der obersten Ebene des Pin-Bodys, nicht in media_source, das nur beschreibt, woher das Bild oder Video kommt. Eine Anfrage für einen Pin mit einem Bild sieht so aus:

{
  "board_id": "123456789012345678",
  "title": "Weeknight tomato pasta",
  "description": "A 20-minute pasta with five ingredients.",
  "alt_text": "A bowl of spaghetti with tomato sauce and fresh basil on a wooden table",
  "media_source": {
    "source_type": "image_url",
    "url": "https://example.com/pasta.jpg"
  }
}

Ein Pin mit mehreren Bildern nutzt source_type: "multiple_image_urls" mit 2 bis 5 Elementen. Jedes Element nimmt url, title, description und link, aber keines nimmt Alt-Text. Der Pin als Ganzes trägt einen alt_text, beschreibe bei einem Pin mit mehreren Bildern also die Bildreihe oder das erste Bild. Video-Pins nutzen source_type: "video_id" und dasselbe Feld auf oberster Ebene.

Die API von Pinterest hat eigene Aufrufkontingente, die das Rate Limit der Pinterest API erklärt. Erscheint ein geplanter Pin nicht, listet warum Pinterest-Pins nicht veröffentlicht werden die häufigen Ursachen.

Wie schreibst du guten Pinterest-Alt-Text?

Guter Pinterest-Alt-Text nennt in ein oder zwei schlichten Sätzen, was das Bild zeigt, samt aller darauf gedruckten Wörter, und überlässt Keywords dem Titel und der Beschreibung. Trägt ein Pin ein Text-Overlay, kann ein Screenreader die ins Bild eingebrannten Wörter nicht lesen, außer der Alt-Text wiederholt sie.

Eine kurze Checkliste:

• Fang mit dem Motiv an. „Ein Flatlay mit Leinentischdecke und Kerzenhaltern aus Messing“ ist besser als „Bild von Tischdeko“.
• Übernimm den Overlay-Text. Steht auf dem Pin in großen Buchstaben „5 Ideen für den Herbsttisch“, gehören diese Wörter in den Alt-Text.
• Lass „Bild von“ und „Pin von“ weg. Screenreader kündigen ein Bild bereits an.
• Lass Hashtags und Links weg. Das Feld ist reiner Text, und die Beschreibung enthält die Suchbegriffe schon.
• Bleib unter 500 Zeichen. Die meisten Bilder brauchen ein bis drei Sätze.

Dieselben Gewohnheiten gelten in anderen Netzwerken, mit anderen Limits. Der Leitfaden zu Barrierefreiheit in Social Media stellt sie nebeneinander.

Welchen Alt-Text sendet AdaptlyPost an Pinterest?

AdaptlyPost sendet den Alt-Text des ersten Bildes als alt_text des Pins an Pinterest, gekürzt auf 500 Zeichen, weil Pinterest einen Alt-Text pro Pin annimmt. Der Hinweis des Editors am Alt-Text-Feld sagt es direkt: „Pinterest uses the first image's alt text.“

Im Editor hat jedes Bild einen Button „Add alt text“, der einen Dialog öffnet, der dich bittet: „Describe the image for people who use screen readers.“ Du schreibst eine Beschreibung pro Bild, jeweils bis zu 1,000 Zeichen. Dieselbe Beschreibung geht an jedes Netzwerk im Beitrag, das Alt-Text annimmt, und für Pinterest nimmt AdaptlyPost die Beschreibung von Bild 1 und kürzt sie auf die 500 Zeichen von Pinterest. Bei einem Pin mit mehreren Bildern sendet AdaptlyPost diese eine Beschreibung für den ganzen Pin. Video-Pins gehen ohne Alt-Text raus. Die AdaptlyPost API funktioniert genauso: mediaAltTexts enthält einen String pro Bild, in der Reihenfolge von mediaUrls, und ihre Dokumentation vermerkt, dass Pinterest „first image only, max 500 characters“ bekommt.

Damit Pinterest eine vollständige Beschreibung bekommt, schreib den Alt-Text des ersten Bildes in 500 Zeichen oder weniger und beschreibe den Pin als Ganzes, wenn er mehr als ein Bild enthält. Der Pinterest-Post-Scheduler kümmert sich um Pinnwand, Titel, Link und Veröffentlichungszeit, und wie du Pinterest-Beiträge planst führt durch die komplette Einrichtung.

Häufig gestellte Fragen

Hat Pinterest Alt-Text?

Ja. Jeder Pin hat in der Pinterest API ein Feld alt_text, eine Beschreibung des Bildes in reinem Text für Screenreader. Es ist nullable, Pins ohne Alt-Text sind also gültig.

Wie hoch ist das Zeichenlimit für Pinterest-Alt-Text?

Das Limit liegt bei 500 Zeichen, festgelegt für alt_text in der Referenz der Pinterest API zum Erstellen und Aktualisieren eines Pins. Der Titel nimmt 100 Zeichen und die Beschreibung 800, und jedes Feld hat sein eigenes Limit.

Wie füge ich einem bestehenden Pin Alt-Text hinzu?

Sende PATCH /v5/pins/{pin_id} mit einem neuen Wert für alt_text über die Pinterest API oder ein Tool, das darauf aufbaut. Der Hilfeartikel „Edit or delete a Pin“ von Pinterest listet Titel, Beschreibung, Link, Pinnwand und Kommentareinstellungen als bearbeitbare Felder und führt Alt-Text nicht auf.

Kann jedes Bild in einem Pin mit mehreren Bildern eigenen Alt-Text haben?

Nein. alt_text sitzt am Pin, nicht an den Elementen in media_source, ein Pin mit mehreren Bildern hat also einen Alt-Text. Beschreibe in diesem einen Feld die Bildreihe oder das erste Bild.

Ist Pinterest-Alt-Text dasselbe wie die Pin-Beschreibung?

Nein. Die Beschreibung hilft dem Algorithmus von Pinterest, „determine relevance for delivery“, und ist für Suchende geschrieben, während Alt-Text das Bild für Menschen mit Screenreader beschreibt. Es sind getrennte Felder mit getrennten Limits von 800 und 500 Zeichen.

Welchen Alt-Text sendet AdaptlyPost an Pinterest?

AdaptlyPost sendet den Alt-Text des ersten Bildes als alt_text des Pins, gekürzt auf 500 Zeichen. Beschreibungen an den anderen Bildern gehen an Netzwerke, die einen pro Bild annehmen, nicht an Pinterest. Video-Pins gehen ohne Alt-Text raus.

Was sollte ich in den Pinterest-Alt-Text schreiben?

Nenne in ein bis zwei schlichten Sätzen, was das Bild zeigt, auch die Wörter, die im Bild stehen. Lass „Bild von“ weg, denn Screenreader sagen ein Bild ohnehin an. Hashtags und Links bleiben draußen, die Suchbegriffe stehen schon in der Beschreibung.

Ist Alt-Text bei Pinterest Pflicht?

Pinterest verlangt ihn nicht. Die Entwicklerdokumentation markiert alt_text als „Nullable“, ein Pin ohne Alt-Text ist also gültig und kommt mit "alt_text": null zurück.

Mit welchem API-Aufruf setze ich Alt-Text für einen neuen Pin?

Sende POST /v5/pins mit alt_text im Request-Body, neben board_id, title, description und media_source. Das Feld liegt auf oberster Ebene des Pins, nicht in media_source.

Wie viele Zeichen kann ich in AdaptlyPost für Alt-Text schreiben?

Der Composer nimmt bis zu 1,000 Zeichen pro Bild an. Pinterest bekommt nur den Alt-Text des ersten Bildes, auf 500 Zeichen gekürzt. Schreib diese erste Beschreibung also in 500 Zeichen oder weniger.