Comment fonctionne le texte alternatif Pinterest sur les Pins et dans l'API

Qu'est-ce que le texte alternatif Pinterest ?

Écrire un texte alternatif Pinterest, c'est remplir le champ alt_text d'un Pin, une description en texte brut de l'image que les lecteurs d'écran lisent à voix haute pour les personnes qui ne peuvent pas la voir. Le champ appartient au Pin, à côté de son titre, de sa description et de son lien, et l'API Pinterest le renvoie sur chaque Pin qu'elle relit.

Le texte alternatif et la description du Pin n'ont pas le même rôle. La description s'adresse aux personnes qui naviguent et au classement de Pinterest : la page des spécifications produit de Pinterest indique « Descriptions are used by our algorithm to determine relevance for delivery. » Le texte alternatif décrit ce que montre l'image, pour les personnes qui utilisent une technologie d'assistance. Une description écrite pour la recherche, comme « pâtes faciles du soir, 20 minutes », n'apprend rien sur l'image à une personne qui utilise un lecteur d'écran. Le texte alternatif du même Pin dirait « un bol de spaghettis à la sauce tomate et au basilic sur une table en bois ».

Les deux ont aussi des limites séparées, donc écrire l'un ne prend pas de place dans l'autre.

Quelle est la limite de caractères du texte alternatif Pinterest ?

La limite de caractères du texte alternatif Pinterest est de 500 caractères, fixée sur le champ alt_text dans la référence de l'API Pinterest pour la création et la mise à jour d'un Pin. Voici comment elle se compare aux autres champs de texte d'un Pin :

La documentation développeur marque alt_text comme « Nullable », donc un Pin sans texte alternatif est valide et revient avec "alt_text": null. Le chiffre de 500 caractères vient de la référence de l'API. Le centre d'aide de Pinterest ne publie pas de chiffre distinct pour le texte alternatif, donc considérez 500 comme le plafond pour tout outil qui écrit dans l'API.

Comment ajouter un texte alternatif à un Pin ?

Vous ajoutez un texte alternatif à un Pin via le champ alt_text à la création ou à la mise à jour du Pin, la méthode que Pinterest documente pour les développeurs et pour les outils construits sur son API. Sur le site et l'app Pinterest, l'article du centre d'aide « Create a Pin from an image or video » liste les champs à remplir : titre, description, lien, tableau, sujets associés, publication ultérieure, les options sur la modification par IA et « More options » pour les commentaires et les recommandations d'achat. Le texte alternatif ne figure pas dans cette liste. L'article « Edit or delete a Pin » liste le titre, la description, le lien, le tableau et les réglages de commentaires, sans texte alternatif non plus.

Il reste donc deux méthodes que Pinterest documente entièrement :

1. Créer le Pin avec un texte alternatif. Envoyez POST /v5/pins avec alt_text dans le corps de la requête, à côté de board_id, title, description et media_source.
2. L'ajouter ou le modifier plus tard. Envoyez PATCH /v5/pins/{pin_id} avec un nouveau alt_text. Le schéma de mise à jour applique la même limite de 500 caractères.

Si votre propre outil de création de Pins affiche un champ de texte alternatif, utilisez-le de la même façon, et restez sous 500 caractères pour que le texte corresponde à ce que l'API accepte. Le reste du processus de création d'un Pin, des tableaux aux formats d'image, est présenté dans comment publier des photos sur Pinterest.

Où placer alt_text dans une requête à l'API Pinterest ?

alt_text se place au premier niveau du corps du Pin dans l'API Pinterest, pas dans media_source, qui ne décrit que la provenance de l'image ou de la vidéo. Une requête pour un Pin à une seule image ressemble à ceci :

{
  "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"
  }
}

Un Pin à plusieurs images utilise source_type: "multiple_image_urls" avec 2 à 5 éléments. Chaque élément accepte un url, un title, une description et un link, et aucun n'accepte de texte alternatif. Le Pin dans son ensemble porte un seul alt_text, donc sur un Pin à plusieurs images, décrivez l'ensemble ou la première image. Les Pins vidéo utilisent source_type: "video_id" et le même champ de premier niveau.

L'API Pinterest a ses propres quotas d'appels, présentés dans la limite de requêtes de l'API Pinterest. Quand un Pin programmé n'apparaît pas, pourquoi les Pins Pinterest ne sont pas publiés liste les causes courantes.

Comment écrire un bon texte alternatif Pinterest ?

Un bon texte alternatif Pinterest nomme ce que montre l'image en une ou deux phrases simples, y compris les mots imprimés dessus, et laisse les mots-clés au titre et à la description. Quand un Pin porte un texte en surimpression, un lecteur d'écran ne peut pas lire les mots intégrés à l'image, sauf si le texte alternatif les reprend.

Une courte liste de vérification :

• Commencez par le sujet. « Une nappe en lin vue de dessus avec des chandeliers en laiton » vaut mieux que « Image de décoration de table ».
• Recopiez le texte en surimpression. Si le Pin affiche « 5 fall table ideas » en grandes lettres, mettez ces mots dans le texte alternatif.
• Évitez « image de » et « Pin de ». Les lecteurs d'écran annoncent déjà une image.
• Laissez de côté les hashtags et les liens. Le champ est en texte brut, et la description contient déjà les termes de recherche.
• Restez sous 500 caractères. La plupart des images demandent une à trois phrases.

Les mêmes habitudes valent sur les autres réseaux, avec d'autres limites. Le guide de l'accessibilité sur les réseaux sociaux les présente côte à côte.

Quel texte alternatif AdaptlyPost envoie-t-il à Pinterest ?

AdaptlyPost envoie à Pinterest le texte alternatif de la première image comme alt_text du Pin, coupé à 500 caractères, parce que Pinterest n'accepte qu'un texte alternatif par Pin. La note du composeur sur le champ de texte alternatif le dit directement : « Pinterest uses the first image's alt text. »

Dans le composeur, chaque image a un bouton « Add alt text » qui ouvre une boîte de dialogue vous demandant de « Describe the image for people who use screen readers. » Vous écrivez une description par image, jusqu'à 1,000 caractères chacune. La même description part vers chaque réseau du post qui accepte un texte alternatif, et pour Pinterest, AdaptlyPost prend la description de l'image 1 et la coupe aux 500 caractères de Pinterest. Sur un Pin à plusieurs images, AdaptlyPost envoie cette seule description pour tout le Pin. Les Pins vidéo partent sans texte alternatif. L'API AdaptlyPost fonctionne de la même façon : mediaAltTexts contient une chaîne par image, dans l'ordre de mediaUrls, et sa documentation précise que Pinterest reçoit « first image only, max 500 characters. »

Pour que Pinterest reçoive une description complète, écrivez le texte alternatif de la première image en 500 caractères au plus, et décrivez le Pin dans son ensemble s'il contient plusieurs images. Le planificateur de posts Pinterest gère le tableau, le titre, le lien et l'heure de publication, et comment programmer des posts Pinterest détaille toute la configuration.

Questions fréquentes

Pinterest a-t-il un texte alternatif ?

Oui. Chaque Pin a un champ alt_text dans l'API Pinterest, une description en texte brut de l'image pour les lecteurs d'écran. Il peut être nul, donc les Pins sans texte alternatif sont valides.

Quelle est la limite de caractères du texte alternatif Pinterest ?

La limite est de 500 caractères, fixée sur alt_text dans la référence de l'API Pinterest pour la création et la mise à jour d'un Pin. Le titre accepte 100 caractères et la description 800, et chaque champ a sa propre limite.

Comment ajouter un texte alternatif à un Pin existant ?

Envoyez PATCH /v5/pins/{pin_id} avec une nouvelle valeur alt_text via l'API Pinterest ou un outil construit dessus. L'article d'aide « Edit or delete a Pin » de Pinterest liste le titre, la description, le lien, le tableau et les réglages de commentaires comme champs modifiables, et ne mentionne pas le texte alternatif.

Chaque image d'un Pin à plusieurs images peut-elle avoir son propre texte alternatif ?

Non. alt_text est porté par le Pin, pas par les éléments de media_source, donc un Pin à plusieurs images n'a qu'un texte alternatif. Décrivez l'ensemble des images, ou la première, dans ce champ unique.

Le texte alternatif Pinterest est-il la même chose que la description du Pin ?

Non. La description aide l'algorithme de Pinterest à « determine relevance for delivery » et s'écrit pour la recherche, tandis que le texte alternatif décrit l'image pour les personnes qui utilisent un lecteur d'écran. Ce sont deux champs distincts, avec des limites distinctes de 800 et 500 caractères.

Quel texte alternatif AdaptlyPost envoie-t-il à Pinterest ?

AdaptlyPost envoie le texte alternatif de la première image comme alt_text du Pin, coupé à 500 caractères. Les descriptions des autres images partent vers les réseaux qui en acceptent une par image, pas vers Pinterest. Les Pins vidéo partent sans texte alternatif.

Que dois-je écrire dans le texte alternatif Pinterest ?

Décrivez ce que montre l'image en une ou deux phrases simples, y compris les mots imprimés dessus. Évitez « image de », car les lecteurs d'écran annoncent déjà une image. Laissez de côté les hashtags et les liens, la description contient déjà les termes de recherche.

Le texte alternatif Pinterest est-il obligatoire ?

Pinterest ne l'exige pas. La documentation développeur marque alt_text comme « Nullable », donc un Pin sans texte alternatif est valide et revient avec "alt_text": null.

Quel appel d'API définit le texte alternatif d'un nouveau Pin ?

Envoyez POST /v5/pins avec alt_text dans le corps de la requête, à côté de board_id, title, description et media_source. Le champ se place au niveau supérieur du Pin, pas dans media_source.

Combien de caractères puis-je écrire pour le texte alternatif dans AdaptlyPost ?

Le composeur accepte jusqu'à 1,000 caractères par image. Pinterest ne reçoit que le texte alternatif de la première image, coupé à 500 caractères, alors écrivez cette première description en 500 caractères ou moins.