Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

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.

60 s

Najduži video priče koji API objavljuje; najkraći traje 3 sekunde, a datoteka može doseći 100 MB.

8 MB

Najveća slika priče, koja mora biti JPEG.

24 hours

Koliko dugo objavljena priča ostaje vidljiva prije isteka.

Under 5

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.
Radite ovo uz EasyCoexistence

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