Publikowanie relacji na Instagramie przez API
API Instagrama publikuje relację z jednego obrazu lub jednego wideo pod publicznym adresem URL: utwórz kontener z media_type STORIES, a następnie go opublikuj. Obrazy to JPEG do 8 MB, wideo trwa od 3 do 60 sekund i może mieć do 100 MB, Meta zaleca kadr 9:16, a relacja znika po 24 godzinach, tak jak w aplikacji.
easyCoexistence publikuje relacje ze zdjęciem i wideo za pomocą publish_instagram_post z Claude, ChatGPT lub własnego kodu i może je planować we własnej kolejce.
Najdłuższe wideo relacji publikowane przez API; najkrótsze ma 3 sekundy, a plik może mieć do 100 MB.
Największy obraz relacji, który musi być w formacie JPEG.
Jak długo opublikowana relacja pozostaje widoczna, zanim wygaśnie.
Wartości metryk relacji tak niskie zwracają błąd 10, za mało widzów, zamiast liczby.
Jak publikuje się relację?
Tymi samymi dwoma wywołaniami co każdy post. POST /<IG_ID>/media z media_type ustawionym na STORIES oraz image_url lub video_url, a następnie POST /<IG_ID>/media_publish z identyfikatorem kontenera. Wideo w relacji jest najpierw przetwarzane, więc status_code kontenera musi mieć wartość FINISHED, zanim można go opublikować.
Dokumentacja Meta opisuje podpis dla zdjęć, wideo i karuzel, ale nie dla relacji, dlatego treści skierowane do odbiorcy powinny znaleźć się w samym obrazie lub wideo.
Jakie są wymagania dla mediów relacji?
Meta zaleca kadr 9:16 zarówno dla obrazów, jak i wideo w relacjach, aby uniknąć przycinania lub pustej przestrzeni.
- Obraz: JPEG, do 8 MB, w sRGB; inne przestrzenie barw są konwertowane.
- Wideo: MOV lub MP4 z kodekiem H.264 lub HEVC i dźwiękiem AAC, 23 do 60 klatek na sekundę, do 1920 pikseli szerokości i 25 Mbps.
- Długość wideo: od 3 do 60 sekund, a plik do 100 MB.
- Proporcje wideo: przyjmowane są wartości od 0,1:1 do 10:1.
Co może zawierać relacja?
Sam obraz lub wideo oraz wzmianki o innych kontach: od lipca 2025 parametr user_tags oznacza publiczne konta w relacjach ze zdjęciem i wideo, a współrzędne x i y są opcjonalne. Meta nie obsługuje publikowania naklejek przez API, więc linki, ankiety i lokalizacje pozostają w aplikacji.
Co dzieje się po opublikowaniu relacji?
Pozostaje aktywna przez 24 godziny, a następnie wygasa, tak jak w aplikacji. Meta podaje aktywne relacje w osobnym edge'u stories; lista mediów konta, GET /<IG_ID>/media, ich nie zawiera. Po odczycie media_type relacji ma wartość IMAGE lub VIDEO, tak jak każde inne media, dlatego relacje rozpoznaje się po miejscu, w którym je znaleziono, a nie po typie.
Jak wracają odpowiedzi i wzmianki?
Jako wiadomości prywatne. Odpowiedź na relację trafia na konto jako DM przez webhook wiadomości, z dołączonym identyfikatorem i adresem URL relacji, i otwiera zwykłe 24-godzinne okno na odpowiedź. Gdy ktoś wspomina konto we własnej relacji, przychodzi to również jako wiadomość, z załącznikiem typu story_mention. Mentions API Meta nie obejmuje relacji.
Jakie metryki podaje relacja?
Zasięg, wyświetlenia, udostępnienia, odpowiedzi, obserwacje, wizyty w profilu, aktywność profilu, nawigację, kliknięcia linków, repostów i łączną liczbę interakcji, odczytywane przez endpoint media insights. Są dostępne tylko przez 24 godziny, a wartość poniżej 5 zwraca kod błędu 10, za mało widzów, zamiast liczby. Odpowiedzi od osób w Europie i Japonii nie są wliczane, a relacja utworzona tam przez konto pokazuje 0 odpowiedzi.
Typowe błędy
- Planowanie naklejki z linkiem. API nie publikuje naklejek, więc link musi dotrzeć do ludzi inaczej, na przykład przez odpowiedź w DM.
- Odczyt metryk relacji następnego dnia. Są dostępne tylko przez 24 godziny, więc zbieraj je, gdy relacja jest aktywna.
- Szukanie opublikowanej relacji na liście mediów konta. Aktywne relacje są wymienione w osobnym edge'u stories.
- Publikowanie wideo poziomego jako relacji. Meta zaleca 9:16, a inne proporcje mogą pokazywać pustą przestrzeń lub zostać przycięte.
Odpowiedzi na relacje trafiają jako DM, które można przekazać do twojego endpointu lub obsłużyć automatyzacją. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, mniej wraz z dodawaniem połączeń, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy mogę dodać naklejkę z linkiem do relacji przez API?
Nie. Meta nie obsługuje publikowania naklejek przez API, w tym linków, ankiet i lokalizacji. Wzmianka o innym koncie bez naklejki jest obsługiwana.
Gdzie w API widać opublikowaną relację?
W osobnym edge'u stories konta, dopóki jest aktywna. GET /<IG_ID>/media nie zawiera relacji, a po odczycie relacja ma wartość IMAGE lub VIDEO.
Czy relacja może mieć podpis przez API?
Nie. Dokumentacja Meta nie opisuje podpisu dla relacji, a publish_instagram_post wysyła relację bez niego, więc treści skierowane do odbiorcy umieść w samym obrazie lub wideo.
Jak długo dostępne są statystyki relacji?
Przez 24 godziny. Meta udostępnia metryki relacji tylko tak długo, więc odczytuj je, gdy relacja jest aktywna.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w