Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram-storyjen julkaiseminen API:n kautta

Instagramin API julkaisee storyn yhdestä kuvasta tai yhdestä videosta, jotka ovat julkisessa URL-osoitteessa: luo container, jonka media_type on STORIES, ja julkaise se. Kuvat ovat JPEG-muodossa, enintään 8 MB, videot kestävät 3–60 sekuntia ja ovat enintään 100 MB. Meta suosittelee 9:16-kehystä, ja story katoaa 24 tunnin kuluttua, kuten sovelluksessakin.

easyCoexistence julkaisee kuva- ja videostoryt publish_instagram_post-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi, ja voi ajastaa ne omasta jonostaan.

60 s

Pisin API:n kautta julkaistava storyvideo; lyhin on 3 sekuntia, ja tiedosto voi olla jopa 100 MB.

8 MB

Suurin storykuva, jonka täytyy olla JPEG-muodossa.

24 hours

Kuinka kauan julkaistu story pysyy näkyvissä ennen vanhenemista.

Under 5

Jos storyn mittarin arvo jää tämän alhaiseksi, palautuu virhekoodi 10 (ei tarpeeksi katsojia) numeron sijaan.

Miten story julkaistaan?

Samalla kahdella API-kutsulla kuin mikä tahansa muu julkaisu. Lähetä POST /<IG_ID>/media, jonka media_type on STORIES ja jolla on joko image_url tai video_url, ja sen jälkeen POST /<IG_ID>/media_publish containerin ID:n kanssa. Videostory käsitellään ensin, joten sen containerin status_code täytyy olla FINISHED ennen julkaisua.

Metan viite kuvaa kuvatekstin valokuville, videoille ja karuselleille, ei storyille, joten katsojalle tarkoitetut sanat kuuluvat kuvaan tai videoon itseensä.

Mitkä ovat storyn mediavaatimukset?

Meta suosittelee 9:16-kehystä sekä storykuville että -videoille, jotta vältetään rajaus tai tyhjä tila.

  • Kuva: JPEG, enintään 8 MB, sRGB-väriavaruudessa; muut väriavaruudet muunnetaan.
  • Video: MOV tai MP4 H.264- tai HEVC-videolla ja AAC-äänellä, 23–60 kuvaa sekunnissa, enintään 1920 pikseliä leveä ja 25 Mbps.
  • Videon pituus: 3–60 sekuntia, tiedosto enintään 100 MB.
  • Videon kuvasuhde: kaikki 0.1:1 ja 10:1 välillä hyväksytään.

Mitä story voi sisältää?

Kuvan tai videon itsensä sekä maininnat muista tileistä: heinäkuusta 2025 lähtien user_tags-parametri merkitsee julkisia tilejä kuva- ja videostoryissa, ja x- ja y-koordinaatit ovat valinnaisia. Meta ei tue tarrojen julkaisemista API:n kautta, joten linkit, kyselyt ja sijainnit pysyvät sovelluksessa.

Mitä tapahtuu julkaisun jälkeen?

Story pysyy näkyvissä 24 tuntia ja vanhenee sitten, kuten sovelluksessa. Meta listaa elävät storyt erillisen stories-edgen kautta, eikä tilin medialuettelo, GET /<IG_ID>/media, sisällä niitä. Takaisin luettuna storyn media_type on IMAGE tai VIDEO, kuten missä tahansa muussa mediassa, joten storyt erotetaan toisistaan sen mukaan, mistä ne löydettiin, eikä tyypin perusteella.

Miten vastaukset ja maininnat palautuvat?

DM-viesteinä. Vastaus storyyn saapuu tilille DM-viestinä messages-webhookin kautta, ja mukana ovat storyn ID ja URL-osoite. Se avaa tavallisen 24 tunnin vastausikkunan. Kun joku mainitsee tilin omassa storyssaan, se saapuu myös viestinä, jonka liitteen tyyppi on story_mention. Metan Mentions API ei kata storyja.

Mitä mittareita story raportoi?

Tavoittavuus, katselukerrat, jakamiset, vastaukset, seuraamiset, profiilikäynnit, profiilin toiminta, navigointi, linkkien napsautukset, uudelleenjaot ja kokonaisvuorovaikutukset, luettuina media insights -endpointin kautta. Ne ovat saatavilla vain 24 tuntia, ja alle 5 arvo palauttaa virhekoodin 10 (ei tarpeeksi katsojia) numeron sijaan. Euroopassa ja Japanissa asuvien ihmisten vastauksia ei lasketa mukaan, ja siellä luodun storyn vastausmäärä on 0.

Yleiset virheet

  • Linkkitarran suunnittelu. API ei julkaise tarroja, joten linkin täytyy saavuttaa ihmiset muuta kautta, esimerkiksi DM-vastauksena.
  • Storymittareiden lukeminen seuraavana päivänä. Ne ovat saatavilla vain 24 tuntia, joten kerää ne storyn ollessa näkyvissä.
  • Julkaistun storyn etsiminen tilin medialuettelosta. Elävät storyt listataan erillisen stories-edgen alla.
  • Vaakasuuntaisen videon julkaiseminen storynä. Meta suosittelee 9:16-kehystä, ja muut muodot voivat näyttää tyhjää tilaa tai leikkautua.
Näin teet tämän EasyCoexistencen avulla

Vastaukset storyihin saapuvat DM-viesteinä, jotka voidaan välittää endpointiisi tai joihin automaatio vastaa. US$ 9–US$ 0.75 per yhteys kuukaudessa, hinta laskee lisäyhteyksien myötä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Voiko storyyn lisätä linkkitarran API:n kautta?

Ei. Meta ei tue tarrojen julkaisemista API:n kautta, linkit, kyselyt ja sijainnit mukaan lukien. Toisen tilin mainitseminen ilman tarraa on tuettu.

Mistä julkaistu story löytyy API:sta?

Tilin erillisestä stories-edgestä sen ollessa elossa. GET /<IG_ID>/media ei sisällä storyja, ja story palautuu tyyppinä IMAGE tai VIDEO.

Voiko storylle antaa kuvatekstin API:n kautta?

Ei. Metan viitteessä ei ole kuvatekstiä storyille, ja publish_instagram_post lähettää storyn ilman sitä, joten katsojalle tarkoitetut sanat kuuluvat kuvaan tai videoon itseensä.

Kuinka kauan storyn tilastot ovat saatavilla?

24 tuntia. Meta tarjoaa storymittarit vain tämän ajan, joten lue ne storyn ollessa näkyvissä.

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