AccediInizia la prova gratuita
easyCoexistence API ufficiali

Limiti della didascalia su Instagram: caratteri, hashtag e tag @ nell'API

L'API di Instagram pubblica una didascalia fino a 2.200 caratteri con una foto, un Reel o un carosello, con al massimo 20 tag @. A novembre 2026 il Centro assistenza di Instagram consente fino a 5 hashtag per post, mentre il riferimento API di Meta ne elenca ancora 30, quindi tieniti su 5. Gli account citati con @ ricevono una notifica al momento della pubblicazione, e una didascalia troppo lunga fallisce con codice 36004, sottocodice 2207010.

easyCoexistence pubblica una foto, un carosello o un Reel con la sua didascalia tramite publish_instagram_post, da Claude, ChatGPT o dal tuo codice, impostando la didascalia una sola volta su un carosello, e list_social_posts legge la didascalia di ogni post.

2,200

Il numero massimo di caratteri che una didascalia può contenere tramite l'API di Instagram.

5

Il numero massimo di hashtag che il Centro assistenza di Instagram consente ora su un post, nella didascalia o nei commenti.

30

Il numero massimo di hashtag per didascalia nel riferimento API di Meta, che riporta ancora la cifra precedente.

20

Il numero massimo di tag @ in una didascalia; superarlo restituisce il codice 100, sottocodice 2207040.

2207010

Sottocodice di errore, sotto il codice 36004, per una didascalia più lunga di quanto Instagram consenta.

Partial

media_publish può riuscire con config_issue CAPTION_NOT_ATTACHED: il post è online senza la sua didascalia.

Quali sono i limiti della didascalia?

Tre, tutti sul parametro caption del contenitore media. Una didascalia può includere hashtag, scritti come #tag, e nomi utente di account Instagram, scritti come @username, entro questi limiti:

  • Lunghezza: fino a 2.200 caratteri.
  • Hashtag: fino a 5 per post secondo il Centro assistenza di Instagram, contando quelli nei commenti; il riferimento API di Meta ne elenca ancora 30.
  • Tag @: fino a 20, e ogni account citato riceve una notifica alla pubblicazione del post.

Quali post accettano una didascalia?

Foto, Reel e caroselli. Su un carosello la didascalia va sul contenitore del carosello, perché le immagini e i video al suo interno non la supportano, e la guida di Meta non descrive alcuna didascalia per le storie, quindi il testo destinato a una storia va inserito nell'immagine o nel video stesso.

Cosa succede quando una didascalia supera un limite?

La richiesta fallisce con un errore che indica il problema. Una didascalia troppo lunga restituisce il codice 36004, sottocodice 2207010, e la soluzione indicata da Meta ribadisce i limiti: al massimo 2.200 caratteri, 30 hashtag e 20 tag @. Più di 20 tag @ può restituire anche il codice 100, sottocodice 2207040. Accorcia la didascalia e invia di nuovo la richiesta.

Quando vengono notificati gli account citati?

Al momento della pubblicazione del contenitore, non della sua creazione. Gli account citati con @ in una didascalia ricevono una notifica in quel momento, quindi un contenitore preparato in anticipo non avvisa nessuno finché non va online. Il limite di Meta di 20 tag @ per didascalia vale anche per queste menzioni.

Un post può andare online senza la sua didascalia?

Sì. media_publish può riuscire con il campo config_issue impostato su CAPTION_NOT_ATTACHED, cioè il contenuto è stato pubblicato senza la didascalia. Meta lo definisce un successo parziale: l'ID del media è valido, quindi riconcilia il post invece di pubblicarlo di nuovo.

Una didascalia può essere modificata dopo la pubblicazione?

Il riferimento sui media di Meta documenta un solo aggiornamento per i media pubblicati: attivare o disattivare i commenti con POST /<IG_MEDIA_ID> e comment_enabled. Non elenca alcun modo per modificare la didascalia, quindi controlla testo, hashtag e tag @ prima di creare il contenitore.

Errori comuni

  • Controllare solo la lunghezza. Una didascalia sotto i 2.200 caratteri viola comunque i limiti con più di 5 hashtag, la regola attuale di Instagram, o più di 20 tag @.
  • Inserire una didascalia nei singoli elementi del carosello. Solo il contenitore del carosello accetta una didascalia.
  • Scrivere una didascalia per una storia. Il contenitore delle storie non ne accetta alcuna, quindi inserisci il testo nell'immagine o nel video.
  • Pubblicare di nuovo dopo CAPTION_NOT_ATTACHED. Il primo post è già online, e una seconda pubblicazione crea un duplicato.
Farlo con EasyCoexistence

Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.

Domande frequenti

Cosa significa l'errore 2207040 su Instagram?

La didascalia ha più di 20 tag @, restituiti con il codice 100. Rimuovi tag fino ad arrivare a 20 o meno e invia di nuovo la richiesta.

Il limite di 5 hashtag di Instagram include gli hashtag nei commenti?

Sì. Il Centro assistenza di Instagram consente fino a 5 hashtag per post, conteggiando quelli nella didascalia e nei commenti.

Posso disattivare i commenti su un post pubblicato tramite l'API?

Sì. POST /<IG_MEDIA_ID> con comment_enabled impostato su false disattiva i commenti, e true li riattiva, l'unico aggiornamento che il riferimento sui media di Meta documenta per i media pubblicati.

Cosa significa l'errore 2207010?

La didascalia è più lunga di quanto Instagram consenta. Accorciala a 2.200 caratteri o meno e invia di nuovo la richiesta.

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