Objavljivanje Instagram priča putem API-ja
Instagramov API objavljuje priču iz jedne slike ili jednog videa na javnom URL-u: kreirajte kontejner s media_type STORIES, zatim ga objavite. Slike su JPEG do 8 MB, videi traju 3 do 60 sekundi i do 100 MB, Meta preporučuje okvir 9:16, a priča nestaje nakon 24 sata, kao u aplikaciji.
easyCoexistence objavljuje slike i videe priča pomoću publish_instagram_post iz Claudea, ChatGPT-ja ili vlastitog koda te ih može zakazati iz vlastitog reda čekanja.
Najduži video priče koji API objavljuje; najkraći traje 3 sekunde, a datoteka može doseći 100 MB.
Najveća slika priče, koja mora biti JPEG.
Koliko dugo objavljena priča ostaje vidljiva prije isteka.
Vrijednosti metrika priče koje su premale vraćaju se kao kôd pogreške 10, nedovoljno gledatelja, umjesto broja.
Kako se priča objavljuje?
Istim dvama pozivima kao i svaka druga objava. POST /<IG_ID>/media s postavljenim media_type na STORIES i image_url ili video_url, zatim POST /<IG_ID>/media_publish s ID-om kontejnera. Video priča se prvo obrađuje, pa status_code kontejnera mora pokazivati FINISHED prije objave.
Referenca tvrtke Meta opisuje opis (caption) za fotografije, videozapise i karusele, ne za priče, pa riječi namijenjene gledatelju pripadaju samoj slici ili videu.
Koji su zahtjevi za medije priče?
Meta preporučuje okvir 9:16 za slike i videe priča, kako bi se izbjeglo rezanje ili prazan prostor.
- Slika: JPEG, do 8 MB, u sRGB; ostali prostori boja se pretvaraju.
- Video: MOV ili MP4 s H.264 ili HEVC videom i AAC zvukom, 23 do 60 sličica u sekundi, do 1920 piksela u širini i 25 Mbps.
- Duljina videa: 3 do 60 sekundi, uz datoteku do 100 MB.
- Omjer stranica videa: prihvaća se sve od 0,1:1 do 10:1.
Što priča može sadržavati?
Samu sliku ili video i oznake drugih računa: od srpnja 2025. parametar user_tags označava javne račune u slikama i videima priča, a koordinate x i y su izborne. Meta ne podržava objavu naljepnica putem API-ja, pa poveznice, ankete i lokacije ostaju u aplikaciji.
Što se događa nakon objave priče?
Ostaje 24 sata i zatim istječe, kao u aplikaciji. Meta navodi aktivne priče na zasebnom stories edgeu; popis medija računa, GET /<IG_ID>/media, ih ne uključuje. Pri čitanju media_type priče glasi IMAGE ili VIDEO, kao i kod svakog drugog medija, pa priče razlikujte prema mjestu na kojem ste ih pronašli, a ne prema tipu.
Kako stižu odgovori i spominjanja?
Kao izravne poruke. Odgovor na priču stiže računu kao DM na messages webhooku, s ID-om i URL-om priče, i otvara uobičajeni 24-satni prozor za odgovor. Kada netko spomene račun u vlastitoj priči, to također stiže kao poruka, s privitkom vrste story_mention. Mentions API tvrtke Meta ne obuhvaća priče.
Koje metrike priča prikazuje?
Doseg, prikazi, dijeljenja, odgovori, praćenja, posjeti profilu, aktivnost profila, navigacija, klikovi na poveznice, ponovne objave i ukupne interakcije, čitaju se putem endpointa media insights. Dostupne su samo 24 sata, a vrijednost manja od 5 vraća kôd pogreške 10, nedovoljno gledatelja, umjesto broja. Odgovori osoba iz Europe i Japana ne ulaze u brojanje, a priča koju kreira račun iz tih zemalja prikazuje 0 odgovora.
Uobičajene pogreške
- Planiranje naljepnice s poveznicom. API ne objavljuje naljepnice, pa poveznica mora do ljudi doći drugim putem, primjerice odgovorom u DM-u.
- Čitanje metrika priče sljedeći dan. Dostupne su samo 24 sata, pa ih prikupite dok je priča aktivna.
- Traženje objavljene priče na popisu medija računa. Aktivne priče se navode na zasebnom stories edgeu.
- Objavljivanje videa u vodoravnom formatu kao priče. Meta preporučuje 9:16, a drugi oblici mogu prikazati prazan prostor ili biti izrezani.
Odgovori na priču stižu kao DM-ovi koji se mogu proslijediti vašem endpointu ili dobiti odgovor putem automatizacije. US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, i besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Mogu li API-jem dodati naljepnicu s poveznicom na priču?
Ne. Meta ne podržava objavu naljepnica putem API-ja, uključujući poveznice, ankete i lokacije. Oznaka drugog računa bez naljepnice je podržana.
Gdje se objavljena priča navodi u API-ju?
Na zasebnom stories edgeu dok je aktivna. GET /<IG_ID>/media ne uključuje priče, a priča se čita kao IMAGE ili VIDEO.
Može li priča imati opis (caption) putem API-ja?
Ne. Meta u referenci ne opisuje opis za priče, a publish_instagram_post šalje priču bez njega, pa riječi namijenjene gledatelju idu u samu sliku ili video.
Koliko dugo su dostupni uvidi u priču?
24 sata. Meta metrike priča čini dostupnima samo toliko, pa ih čitajte dok je priča aktivna.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na