Publicarea Story-urilor Instagram prin API
API-ul Instagram publică un Story dintr-o singură imagine sau un singur video de la un URL public: creați un container cu media_type STORIES, apoi îl publicați. Imaginile sunt JPEG de până la 8 MB, videoclipurile durează între 3 și 60 de secunde și au până la 100 MB, Meta recomandă un cadru 9:16, iar Story-ul dispare după 24 de ore, ca în aplicație.
easyCoexistence publică imagini și videoclipuri Story cu publish_instagram_post din Claude, ChatGPT sau din propriul cod și le poate programa din coada sa.
Cel mai lung video Story pe care API-ul îl publică; cel mai scurt are 3 secunde, iar fișierul poate ajunge la 100 MB.
Cea mai mare imagine Story, care trebuie să fie în format JPEG.
Cât timp rămâne vizibil un Story publicat înainte să expire.
Valorile metricilor Story atât de mici se returnează ca eroarea 10, număr insuficient de vizualizări, în loc de o cifră.
Cum se publică un Story?
Cu aceleași două apeluri ca orice postare. POST /<IG_ID>/media cu media_type setat la STORIES și fie image_url, fie video_url, apoi POST /<IG_ID>/media_publish cu ID-ul containerului. Un Story video este procesat mai întâi, deci status_code al containerului trebuie să arate FINISHED înainte de a putea fi publicat.
Referința Meta descrie legenda pentru fotografii, videoclipuri și carusele, nu pentru Story-uri, deci cuvintele destinate spectatorului trebuie să fie chiar în imagine sau în video.
Ce cerințe au fișierele pentru Story?
Meta recomandă un cadru 9:16 atât pentru imaginile, cât și pentru videoclipurile Story, pentru a evita decuparea sau spațiul gol.
- Imagine: JPEG, de până la 8 MB, în sRGB; celelalte spații de culoare sunt convertite.
- Video: MOV sau MP4 cu video H.264 sau HEVC și audio AAC, 23 până la 60 de cadre pe secundă, până la 1920 de pixeli lățime și 25 Mbps.
- Durata videoclipului: între 3 și 60 de secunde, cu un fișier de până la 100 MB.
- Raportul de aspect al videoclipului: orice valoare între 0,1:1 și 10:1 este acceptată.
Ce poate conține un Story?
Imaginea sau videoclipul în sine și mențiuni ale altor conturi: din iulie 2025, parametrul user_tags etichetează conturile publice în Story-urile cu imagine și video, iar coordonatele x și y sunt opționale. Meta nu acceptă publicarea stickerelor prin API, deci linkurile, sondajele și locațiile rămân în aplicație.
Ce se întâmplă după publicarea unui Story?
Rămâne activ 24 de ore și apoi expiră, ca în aplicație. Meta listează Story-urile active pe un edge separat pentru stories; lista de media a contului, GET /<IG_ID>/media, nu le include. Citit înapoi, media_type al unui Story este IMAGE sau VIDEO, ca la orice alt conținut media, deci Story-urile se recunosc după locul unde le-ați găsit, nu după tip.
Cum ajung răspunsurile și mențiunile?
Ca mesaje directe (DM). Un răspuns la un Story ajunge la cont ca DM pe webhook-ul de mesaje, cu ID-ul și URL-ul Story-ului atașate, și deschide fereastra obișnuită de 24 de ore pentru răspuns. Când cineva menționează contul în propriul Story, mențiunea sosește tot ca mesaj, cu un atașament de tip story_mention. API-ul de mențiuni al Meta nu acoperă Story-urile.
Ce metrici raportează un Story?
Acoperire, vizualizări, distribuiri, răspunsuri, urmăriri, vizite ale profilului, activitatea profilului, navigarea, clicurile pe linkuri, repostările și interacțiunile totale, citite prin endpoint-ul de insights pentru media. Sunt disponibile doar 24 de ore, iar o valoare sub 5 returnează codul de eroare 10, număr insuficient de vizualizări, în loc de o cifră. Răspunsurile de la persoane din Europa și Japonia nu sunt numărate, iar un Story creat de un cont de acolo raportează 0 răspunsuri.
Greșeli frecvente
- Planificarea unui sticker cu link. API-ul nu publică stickere, deci un link trebuie să ajungă la oameni altfel, de exemplu printr-un răspuns sub formă de mesaj direct.
- Citirea metricilor Story a doua zi. Sunt disponibili doar 24 de ore, deci colectați-le cât timp Story-ul este activ.
- Căutarea unui Story publicat în lista de media a contului. Story-urile active sunt listate pe un edge separat pentru stories.
- Publicarea unui videoclip pe orizontală ca Story. Meta recomandă 9:16, iar alte forme pot afișa spațiu gol sau pot fi decupate.
Răspunsurile la un Story ajung ca mesaje directe, care pot fi trimise mai departe către endpoint-ul dumneavoastră sau pot primi un răspuns dintr-o automatizare. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni și perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Pot adăuga un sticker cu link la un Story prin API?
Nu. Meta nu acceptă publicarea stickerelor prin API, inclusiv a linkurilor, sondajelor și locațiilor. Menționarea altui cont fără sticker este acceptată.
Unde apare un Story publicat în API?
Pe edge-ul separat pentru stories al contului, cât timp este activ. GET /<IG_ID>/media nu include Story-urile, iar un Story se citește ca IMAGE sau VIDEO.
Pot avea un Story legendă prin API?
Nu. Referința Meta nu descrie legendă pentru Story-uri, iar publish_instagram_post trimite un Story fără legendă, deci cuvintele destinate spectatorului trebuie să fie în imagine sau în video.
Cât timp sunt disponibile insights-urile Story-urilor?
Timp de 24 de ore. Meta face metricile Story-urilor disponibile doar atât, deci citiți-le cât timp Story-ul este activ.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la