Przewodnik po Instagram API w 2026 roku: od aplikacji do pierwszego posta
W 2026 roku Instagram API prowadzi aplikację do pierwszego posta w sześciu krokach: profesjonalne konto, konfiguracja logowania, aplikacja Meta, uprawnienia na właściwym poziomie dostępu, token dostępu, a następnie kontener mediów utworzony poleceniem POST /<IG_ID>/media i opublikowany przez media_publish. Komentarze, wiadomości prywatne, webhooki, statystyki i limity Meta pojawiają się później. Dla nowych aplikacji Meta zaleca Unified Login.
easyCoexistence zamienia kroki 2 do 5 w jedno logowanie przez Instagram: jej aplikacja Meta prowadzi logowanie, odnawia token przed wygaśnięciem i sprawdza konto co 6 godzin, a Claude, ChatGPT lub Twoja własna platforma publikuje, planuje, odpowiada na komentarze i wiadomości oraz czyta statystyki przez oficjalne API Meta.
Unified Login, zalecany dla nowych integracji, oraz Instagram Login i Facebook Login, zachowane dla istniejących.
Nowo utworzone aplikacje Meta nie mogą konfigurować Instagram API za pomocą Instagram Login, według przewodnika migracji Meta.
Jak długo trwa długoterminowy token użytkownika Instagram; można go odświeżyć, gdy ma 24 godziny.
Liczba postów opublikowanych przez API, jaką jedno konto może wykonać w ruchomym okresie 24 godzin; karuzela liczy się jako jeden.
Ile czasu zajmuje App Review, według Meta; zwykle zgłoszenie jest rozpatrywane krócej niż tydzień.
Jakie są kroki od nowej aplikacji do pierwszego posta?
Sześć kroków prowadzi do pierwszego posta, a cztery kolejne określają, co aplikacja robi później. Konto musi być profesjonalne, aplikacja wybiera jedną z trzech konfiguracji logowania Meta, właściciel konta przyznaje uprawnienia, a serwer aplikacji przechowuje token. Publikacja to następnie dwa wywołania. Komentarze, wiadomości prywatne, webhooki, statystyki i limity pojawiają się dalej, a ostatnie sekcje wskazują stronę, która omawia każdy krok w całości.
Krok 1: które konto Instagram działa z API?
Konto profesjonalne, firmowe lub twórcy. Instagram Platform Meta obsługuje wyłącznie konta profesjonalne, a oba typy działają tak samo przy publikacji, komentarzach, wiadomościach i statystykach. Konto osobiste przełącza się w aplikacji Instagram, w sekcji Typ konta i narzędzia, a konto prywatne staje się publiczne po przełączeniu. Instagram Login i Unified Login nie wymagają podpiętej strony, natomiast Facebook Login ją wymaga.
Krok 2: jakiej konfiguracji logowania powinna użyć aplikacja?
Meta dokumentuje trzy, a wybór ustala host, token i nazwy uprawnień. Jej przegląd poleca Unified Login dla nowych integracji, strona Unified Login mówi, że nowe funkcje Instagram API są udostępniane wyłącznie tam, a przewodnik migracji wskazuje, że nowo utworzone aplikacje nie mogą konfigurować Instagram Login. Istniejące integracje Instagram Login nadal działają, bez ogłoszonej daty zakończenia.
- Unified Login: klient loguje się przez Instagram lub przez Facebook Login, wybiera portfolio firmy, a aplikacja otrzymuje token Business Integration System User.
- Instagram Login: właściciel loguje się przez Instagram, a wywołania kierowane są do graph.instagram.com z tokenem użytkownika Instagram i uprawnieniami instagram_business_*.
- Facebook Login: konto musi być powiązane ze stroną, którą dana osoba może zarządzać, z uprawnieniami instagram_* i uprawnieniami stron.
Krok 3: jak tworzy się aplikację Meta?
W App Dashboard, według ścieżki zależnej od konfiguracji. Przewodnik Meta po Unified Login zaczyna od aplikacji z przypadkiem użycia Manage messaging & content on Instagram, należącej do portfolio firmy. W sekcji API setup with Unified login aplikacja tworzy konfigurację, której config_id określa uprawnienia i zasoby do żądania, zapisuje adres przekierowania HTTPS i kopiuje adres URL logowania. Istniejąca aplikacja Instagram Login zachowuje API setup with Instagram login, gdzie znajdują się jej identyfikator aplikacji Instagram i sekret.
Krok 4: jakich uprawnień i poziomu dostępu potrzebuje aplikacja?
Jedno uprawnienie na funkcję, przyznawane przez właściciela konta przy logowaniu. Unified Login używa rodziny instagram_*, na przykład instagram_content_publish i instagram_manage_comments, a Instagram Login nazw instagram_business_*. Standard Access, domyślny, obejmuje konta, którymi zarządzasz lub które posiadasz, oraz osoby z rolą w aplikacji. Obsługa cudzych firm wymaga Advanced Access, przyznawanego uprawnienie po uprawnieniu przez App Review, wraz z Business Verification.
Krok 5: jak aplikacja otrzymuje token dostępu?
Z logowania właściciela, wymieniany na serwerze, nigdy w przeglądarce ani aplikacji mobilnej. Przy Instagram Login przekierowanie zawiera kod ważny przez godzinę i możliwy do użycia raz; zamienia się on w token krótkoterminowy, a następnie w długoterminowy, który trwa 60 dni i można go odświeżyć, gdy ma jeden dzień. Przy Unified Login kod zamienia się w token Business Integration System User, którego wygaśnięcie zależy od konfiguracji.
Krok 6: jak opublikować pierwszy post?
Dwoma wywołaniami. POST /<IG_ID>/media z publicznym image_url, który Meta pobiera samodzielnie, tworzy kontener; POST /<IG_ID>/media_publish z identyfikatorem tego kontenera jako creation_id go publikuje i zwraca identyfikator mediów. Obrazy muszą być w formacie JPEG. W przypadku Reela lub innego wideo sprawdzaj status_code kontenera, aż przyjmie wartość FINISHED, ponieważ wcześniej publikacja się nie powiedzie.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
?image_url=https://www.example.com/images/first-post.jpg
&caption=Hello%20from%20the%20API
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_CONTAINER_ID>" }
POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
?creation_id=<IG_CONTAINER_ID>
&access_token=<ACCESS_TOKEN>
{ "id": "<IG_MEDIA_ID>" }Krok 7: jak działają komentarze i wiadomości prywatne?
Oba zaczynają się od kogoś innego. GET /<IG_MEDIA_ID>/comments zwraca do 50 komentarzy najwyższego poziomu na żądanie, POST /<IG_COMMENT_ID>/replies odpowiada na jeden z nich publicznie, a prywatna odpowiedź wysyła komentującemu jedną wiadomość w ciągu 7 dni od komentarza. Wiadomości trafiają do osób, które napisały pierwsze, w standardowym 24-godzinnym oknie dla większości działań, po tym jak właściciel włączy Allow access to messages w aplikacji Instagram.
Krok 8: jak webhooki informują aplikację o zdarzeniach?
Meta wysyła JSON na endpoint HTTPS, który potwierdza się raz, odsyłając hub.challenge, i podpisuje każde zdarzenie w nagłówku X-Hub-Signature-256 jako HMAC-SHA256 payloadu, kluczem jest sekret aplikacji. Aplikacja wybiera w App Dashboard pola, takie jak comments i messages, a następnie subskrybuje każde konto przez jego krawędź subscribed_apps. Powiadomienia trafiają wyłącznie do aplikacji w trybie Live, a powiadomienia o komentarzach wymagają Advanced Access.
Krok 9: jak aplikacja odczytuje statystyki?
Z dwóch krawędzi: GET /<IG_ID>/insights dla konta i GET /<IG_MEDIA_ID>/insights dla posta, Reela lub Story. Metryki konta, takie jak reach, views i accounts_engaged, przyjmują period=day z metric_type=total_value. views zastąpiło impressions w 2025 roku, niektóre metryki wymagają co najmniej 100 obserwujących, a Meta zaznacza, że dane mogą opóźniać się nawet o 48 godzin.
Krok 10: jakie limity kształtują aplikację?
Meta ustala główne limity dla każdego konta, więc nowe konto otrzymuje własną pulę zamiast dzielić jedną:
- Wywołania: 4,800 razy liczba wyświetleń konta w kroczącym 24-godzinnym okresie, na aplikację i konto, bez wiadomości.
- Publikowanie: 100 postów opublikowanych przez API i 400 kontenerów mediów na konto w ciągu 24 godzin.
- Wiadomości: 100 wywołań Send API na sekundę dla tekstu oraz 750 prywatnych odpowiedzi na godzinę pod postami i Reelami.
- Kontenery: nieopublikowany przez 24 godziny kontener wygasa i trzeba go utworzyć ponownie.
Która strona omawia każdy krok szczegółowo?
Każdy krok ma własną stronę referencyjną w tej dokumentacji, z polami, błędami i przypadkami brzegowymi, których ten przewodnik nie zawiera. Poniższe ścieżki znajdują się pod adresem strony, a strona z kodem pokazuje wywołania publikacji, komentarzy, statystyk i webhooków w Pythonie i Node.js obok siebie:
Jaka jest ścieżka przez easyCoexistence?
Jedno logowanie zamiast kroków 2 do 5 i konfiguracji webhooków. W panelu wybierz New connection, potem Instagram, zaloguj się na konto Business lub Creator i zatwierdź jego pięć uprawnień instagram_business_*. Aplikacja Meta easyCoexistence przeprowadza logowanie, odnawia token i sprawdza konto co 6 godzin. Claude, ChatGPT lub własny agent działa wtedy przez https://easycoexistence.com/api/mcp, własny kod może pobrać ID konta i bazę API z get_social_credentials, a posty można planować nawet na 90 dni wprzód z kolejki easyCoexistence.
Typowe błędy
- Rozpoczynanie nowej aplikacji od Instagram Login. Przewodnik migracji Meta mówi, że nowo utworzone aplikacje nie mogą jej tak skonfigurować, a przegląd poleca Unified Login dla nowych integracji.
- Wywoływanie integracji Unified Login tokenem użytkownika Instagram. Przewodnik Meta po webhookach mówi, że te tokeny i graph.instagram.com nie działają z Unified Login.
- Publikowanie kontenera wideo od razu. media_publish kończy się błędem z podkodem 2207027, dopóki status_code kontenera nie przyjmie wartości FINISHED.
- Odpytywanie o komentarze i wiadomości. Meta zaleca webhooki, które zmniejszają liczbę wywołań aplikacji i ryzyko przekroczenia limitów.
US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Jak długo trwa uzyskanie dostępu do Instagram API?
Dla kont, które posiadasz lub którymi zarządzasz, bez czekania: Standard Access działa od początku. Obsługa cudzych firm wymaga App Review, które według Meta zwykle trwa krócej niż tydzień, oraz Business Verification.
Czy nowa aplikacja Meta może nadal używać Instagram Login?
Według przewodnika migracji Meta nie, bo nowo utworzone aplikacje nie mogą jej skonfigurować. Istniejące integracje Instagram Login nadal działają, a Meta nie ogłosiła daty zakończenia.
Czy API może opublikować plik z mojego komputera?
Nie przy Instagram Login, gdzie Meta pobiera każdy obraz lub wideo z publicznego adresu URL. Meta dokumentuje wznawialne przesyłanie, które przyjmuje lokalny plik wideo, w konfiguracjach opartych na Facebook Login for Business, także w Unified Login.
Ile kosztuje easyCoexistence dla konta Instagram?
Każde konto Instagram to jedno połączenie: od US$ 9 do US$ 0.75 za połączenie miesięcznie, cena spada wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.
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