Testo alternativo sui post Instagram tramite API
L'API di Instagram aggiunge il testo alternativo a un post con immagine tramite il parametro alt_text, impostato alla creazione del container del media. Accetta fino a 1.000 caratteri e funziona su una singola foto o su ogni immagine di un carosello, mentre Reel e Storie non lo supportano. Meta ha aggiunto il campo il 24 marzo 2025.
easyCoexistence pubblica foto e caroselli con publish_instagram_post da Claude, ChatGPT o dal tuo codice.
La quantità massima di testo alternativo che un'immagine può contenere tramite API.
Quando Meta ha introdotto il campo alt_text per i post con immagini sull'endpoint media.
alt_text funziona su immagini singole e immagini del carosello; Reel e Storie non sono supportati.
Campo dei media pubblicati che restituisce il testo descrittivo di un'immagine, per l'accessibilità.
Che cos'è il testo alternativo su un post Instagram?
Una descrizione scritta di un'immagine, che il riferimento media di Meta chiama testo descrittivo per le immagini, per l'accessibilità. Tramite API si imposta per ogni immagine con il parametro alt_text alla creazione del container e si legge dal campo alt_text una volta pubblicato il post.
Come si aggiunge il testo alternativo?
Con alt_text sul container dell'immagine. POST /<IG_ID>/media con image_url, la didascalia e alt_text lo crea, e POST /<IG_ID>/media_publish lo pubblica come al solito. Per un carosello, imposta alt_text sul container di ogni elemento immagine, quelli creati con is_carousel_item impostato su true, prima di creare il container del carosello.
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/photo.jpg",
"caption": "<CAPTION>",
"alt_text": "<WHAT_THE_IMAGE_SHOWS>"
}Quali post supportano il testo alternativo?
Solo i post con immagini, come descrive il riferimento di Meta per il parametro:
- Un post con una singola immagine: supportato, fino a 1.000 caratteri.
- Immagini in un carosello: supportato, ognuna con il proprio testo.
- Video, compresi gli elementi video in un carosello: non supportato.
- Reel e Storie: non supportati.
- Il container del carosello: il testo va invece sui suoi elementi immagine.
Come si legge il testo alternativo?
Richiedi il campo alt_text sull'immagine pubblicata, GET /<IG_MEDIA_ID>?fields=alt_text. È un campo pubblico dell'oggetto media, quindi può essere richiesto anche per le immagini di un carosello tramite l'edge children, che elenca le foto e i video all'interno del post.
Il testo alternativo si può modificare dopo la pubblicazione?
Meta non documenta alcun modo per farlo. L'unico aggiornamento che il suo riferimento media elenca per un post pubblicato attiva o disattiva i commenti, quindi il testo alternativo va scritto nel container prima che il post vada online, insieme alla didascalia e all'URL dell'immagine.
Errori comuni
- Inviare alt_text con un Reel o una Storia. Meta lo supporta solo sui post con immagini.
- Metterlo sul container del carosello. Il testo alternativo appartiene a ogni elemento immagine nel carosello.
- Scrivere oltre 1.000 caratteri. È il massimo che il testo alternativo di un'immagine può contenere.
Lo strumento non accetta alt_text, quindi la descrizione si aggiunge nell'app di Instagram, dall'opzione Modifica del post. Da US$ 9 a US$ 0,75 per connessione al mese, con calo man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.
Domande frequenti
Quanto può essere lungo il testo alternativo tramite l'API di Instagram?
Fino a 1.000 caratteri per immagine, impostati con alt_text sul container di ogni immagine, quindi ogni immagine di un carosello ha il proprio testo.
Un Reel può avere il testo alternativo tramite API?
No. Meta non supporta alt_text su Reel o Storie.
Come aggiungo il testo alternativo a un carosello?
Imposta alt_text sul container di ogni elemento immagine, creato con is_carousel_item impostato su true, prima di creare il container del carosello.
Quando l'API di Instagram ha aggiunto il testo alternativo?
Meta ha introdotto il campo alt_text per i post con immagini il 24 marzo 2025.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il