Instagram-kuvatekstin rajat: merkit, hashtagit ja @-maininnat API:ssa
Instagramin API julkaisee kuvatekstin, jonka pituus on enintään 2 200 merkkiä, kuvan, Reelin tai karusellin kanssa, ja siinä voi olla enintään 20 @-mainintaa. Marraskuusta 2026 alkaen Instagramin ohjekeskus sallii julkaisussa 5 hashtagia, kun Metan API-viite listaa yhä 30, joten pidä ne viidessä. Mainitut tilit saavat ilmoituksen julkaisun hetkellä, ja liian pitkä kuvateksti epäonnistuu virhekoodilla 36004 ja alikoodilla 2207010.
easyCoexistence julkaisee kuvan, karusellin tai Reelin kuvatekstineen publish_instagram_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi.
Suurin merkkimäärä, jonka kuvateksti voi sisältää Instagramin API:n kautta.
Suurin hashtagien määrä, jonka Instagramin ohjekeskus sallii nyt julkaisussa, kuvatekstissä tai kommenteissa.
Suurin hashtagien määrä kuvatekstissä Metan API-ohjeessa, joka antaa yhä vanhan luvun.
Suurin @-maininnan määrä yhdessä kuvatekstissä. Sen ylittäminen palauttaa koodin 100 ja alikoodin 2207040.
Virheen alikoodi koodin 36004 alla kuvatekstille, joka on pidempi kuin Instagram sallii.
media_publish voi onnistua tilalla config_issue CAPTION_NOT_ATTACHED: julkaisu on näkyvissä ilman kuvatekstiä.
Mitkä ovat kuvatekstin rajat?
Kolme, ja ne koskevat kaikki media-containerin caption-parametria. Kuvatekstissä voi olla hashtageja, kirjoitettuna muodossa #tagi, ja Instagram-tilien käyttäjänimiä, kirjoitettuna muodossa @käyttäjänimi, seuraavien rajojen sisällä:
- Pituus: enintään 2 200 merkkiä.
- Hashtagit: Instagramin ohjekeskuksen mukaan enintään 5 julkaisua kohden, kommentit mukaan luettuina; Metan API-viite listaa yhä 30.
- @-maininnat: enintään 20. Jokainen mainittu tili saa ilmoituksen julkaisun hetkellä.
Mihin julkaisuihin kuvateksti kuuluu?
Kuviin, Reeleihin ja karuselleihin. Karuselissa kuvateksti kuuluu karuselli-containeriin, koska sen sisällä olevat kuvat ja videot eivät tue sitä. Metan ohjeessa ei ole kuvatekstiä Storyille, joten Storyyn tarkoitetut sanat kuuluvat itse kuvaan tai videoon.
Mitä tapahtuu, kun kuvateksti rikkoo rajan?
Pyyntö epäonnistuu virheellä, joka kertoo ongelman. Liian pitkä kuvateksti palauttaa koodin 36004 ja alikoodin 2207010, ja Metan korjausohje toistaa rajat: enintään 2 200 merkkiä, 30 hashtagia ja 20 @-mainintaa. Yli 20 @-mainintaa voi palauttaa myös koodin 100 ja alikoodin 2207040. Lyhennä kuvateksti ja lähetä pyyntö uudelleen.
Milloin mainitut tilit saavat ilmoituksen?
Kun container julkaistaan, ei kun se luodaan. Kuvatekstissä mainitut tilit saavat ilmoituksen juuri silloin, joten etukäteen valmisteltu container ei ilmoita kenellekään ennen kuin se menee näkyviin. Metan 20 @-maininnan raja kuvatekstiä kohden koskee näitä mainintoja.
Voiko julkaisu olla näkyvissä ilman kuvatekstiä?
Kyllä. media_publish voi onnistua, kun config_issue-kenttä on asetettu arvoon CAPTION_NOT_ATTACHED. Se tarkoittaa, että media julkaistiin ilman kuvatekstiä. Meta kutsuu tätä osittaiseksi onnistumiseksi: media-ID on kelvollinen, joten tarkista julkaisu sen sijaan, että julkaisisit sen uudelleen.
Voiko kuvatekstiä muuttaa julkaisun jälkeen?
Metan media-ohjeessa on dokumentoitu yksi päivitys julkaistulle medialle: kommentit voi laittaa päälle tai pois POST /<IG_MEDIA_ID> ja comment_enabled-kentän avulla. Siinä ei ole keinoa muokata kuvatekstiä, joten tarkista teksti, hashtagit ja @-maininnat ennen containerin luomista.
Yleiset virheet
- Pelkän pituuden tarkistaminen. Alle 2 200 merkin kuvateksti rikkoo silti rajat, jos siinä on yli 5 hashtagia, mikä on Instagramin nykyinen sääntö, tai yli 20 @-mainintaa.
- Kuvatekstin lisääminen karusellin kohteisiin. Vain karusellin container ottaa kuvatekstin.
- Kuvatekstin kirjoittaminen Storylle. Storyn container ei ota kuvatekstiä, joten laita sanat kuvaan tai videoon.
- Julkaiseminen uudelleen CAPTION_NOT_ATTACHED-virheen jälkeen. Ensimmäinen julkaisu on jo näkyvissä, ja toinen julkaisu luo kaksoiskappaleen.
Karuselliin kuvateksti asetetaan kerran, ja list_social_posts lukee jokaisen julkaisun kuvatekstin takaisin. Hinta on US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, ja se laskee yhteyksiä lisättäessä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Mitä virhe 2207040 tarkoittaa Instagramissa?
Kuvatekstissä on yli 20 @-mainintaa, ja se palautetaan koodina 100. Poista maininnat, kunnes niitä on 20 tai vähemmän, ja lähetä pyyntö uudelleen.
Lasketaanko Instagramin 5 hashtagin raja kommenteissa oleviin hashtageihin?
Kyllä. Instagramin ohjekeskus sallii enintään 5 hashtagia julkaisua kohden, ja siihen lasketaan sekä kuvatekstissä että kommenteissa olevat hashtagit.
Voinko poistaa kommentit käytöstä julkaistusta julkaisusta API:n kautta?
Kyllä. POST /<IG_MEDIA_ID> ja comment_enabled asetettuna arvoon false poistavat kommentit käytöstä, ja arvo true ottaa ne takaisin käyttöön. Tämä on ainoa päivitys, jonka Metan media-ohje dokumentoi julkaistulle medialle.
Mitä virhe 2207010 tarkoittaa?
Kuvateksti on pidempi kuin Instagram sallii. Lyhennä se enintään 2 200 merkkiin ja lähetä pyyntö uudelleen.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu