Pobieranie postów konta Instagram przez API
GET /<IG_ID>/media zwraca posty profesjonalnego konta Instagram jako obiekty IG Media, maksymalnie 10 000 najnowszych. Poproś o pola takie jak id, media_type, media_url, permalink, thumbnail_url i timestamp, a elementy karuzeli odczytasz przez children. Odpowiedzi zawierają kursory before i after do stronicowania, a parametry since i until ograniczają wyniki do zakresu dat. Przy Instagram Login żądanie kierujesz do graph.instagram.com.
easyCoexistence wyświetla posty podłączonego konta Instagram przez list_social_posts, po 1 do 100 naraz, z poziomu Claude, ChatGPT lub własnego kodu, przez oficjalne API Meta z dodanym tokenem.
Maksymalna liczba najnowszych mediów, jaką zwraca media edge, według referencji Meta IG User Media.
Parametry stronicowania opartego na czasie w media edge, przyjmujące znaczniki czasu Unix lub wartości strtotime.
Skąd czytać Stories: media edge nie zwraca mediów typu Story.
Typ mediów, który zwraca thumbnail_url, czyli adres URL miniatury mediów.
Zalecenie Meta dotyczące media_url, którego brakuje w niektórych filmach: w takim przypadku użyj permalink lub thumbnail_url jako zapasowego.
Jak pobrać posty konta?
Żądaniem GET do media edge konta, z podaniem pól do zwrócenia; bez parametru fields przykład z dokumentacji Meta zwraca tylko id każdego posta. Przy Instagram Login żądanie idzie na graph.instagram.com z tokenem dostępu użytkownika Instagram, który ma uprawnienie instagram_business_basic. Odpowiedź wymienia posty w data, a obiekt paging wskazuje kolejną stronę.
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}Jakie pola może zwrócić każdy post?
Pola obiektu IG Media wymienione w referencji Meta; proś tylko o te, których używasz. Dwa wiersze tej referencji, caption i media_product_type, mają adnotację „Dostępne dla Instagram API tylko przy logowaniu przez Facebook Login”, więc sprawdź je w swojej konfiguracji przed użyciem:
Jak działa stronicowanie?
Kursorami. Obiekt paging zawiera kursory before i after oraz, dopóki zostają wyniki, adres URL next. Przewodnik Graph API od Meta zaleca zatrzymać się, gdy next znika, ponieważ strona może zawierać mniej elementów, niż wynosi limit. Media edge stronicuje też w czasie: since i until przyjmują znaczniki czasu Unix lub wartości strtotime i ograniczają wyniki do tego zakresu.
Jak odczytać zdjęcia i filmy z karuzeli?
Przez children edge. Post, którego media_type to CAROUSEL_ALBUM, zwraca swoje elementy pod adresem GET /<IG_MEDIA_ID>/children, z tym samym tokenem i uprawnieniem co media edge. Każdy element to obiekt IG Media z własnym id, media_type i media_url. Meta zauważa, że niektórych pól, w tym permalink, nie da się użyć dla zdjęć w albumie.
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>Dlaczego na części postów brakuje media_url?
Meta pomija je w filmach zawierających chronione prawem autorskim lub licencjonowane audio, w tym utwory z biblioteki dźwięków Instagram, oraz w mediach oznaczonych jako naruszające prawa autorskie, także w postach samego konta. Referencja każe traktować media_url jako opcjonalne i wtedy sięgnąć po permalink lub thumbnail_url. Film na żywo (Live) można odczytać tylko w trakcie transmisji.
Jak pokazać posty na stronie internetowej?
Z serwera, tokenem długoterminowym, ważnym 60 dni, który trzeba odświeżyć przed wygaśnięciem. Linkuj każdy kafelek do jego permalinku i odświeżaj listę według harmonogramu: Meta udostępnia media przez zabezpieczone prywatnością adresy CDN, które przestają zwracać plik po usunięciu lub wygaśnięciu treści. Aby pokazać post tak, jak rysuje go Instagram, przekaż jego permalink do endpointu oEmbed.
Jak wyświetlić posty przez easyCoexistence?
Za pomocą list_social_posts, które przyjmuje account_id oraz limit od 1 do 100, domyślnie 25, i zwraca najnowsze posty konta z identyfikatorami, typami mediów, adresami URL mediów, miniaturami, permalinkami, znacznikami czasu oraz liczbą polubień i komentarzy. Odczytuje najnowsze posty, do 100, i nie ma kursora do dalszych stron ani innych pól.
Typowe błędy
- Szukanie Stories w media edge. Meta je pomija; GET /<IG_ID>/stories zwraca je w ciągu 24 godzin, przez które są widoczne.
- Budowanie kanału wyłącznie na media_url. Meta pomija je przy niektórych filmach, więc zachowaj permalink lub thumbnail_url jako zapasowy.
- Żądanie permalink dla elementów karuzeli. Meta nie zwraca go dla zdjęć w albumie, więc linkuj do posta nadrzędnego.
- Traktowanie krótkiej strony jako ostatniej. Strona może zawierać mniej elementów niż limit; zatrzymaj się dopiero wtedy, gdy stronicowanie nie ma next.
Od US$ 9 za połączenie miesięcznie, spadając do US$ 0.75 wraz z dodawaniem kolejnych połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Ile postów może zwrócić Instagram API?
Maksymalnie 10 000 najnowszych, po jednej stronie naraz z media edge. Stories pochodzą z osobnego stories edge, dopóki są widoczne.
Czy media edge zawiera Reels?
Tak. Reel to obiekt IG Media jak zdjęcie, zgłaszany z media_type VIDEO. Stories są jedynym typem, którego media edge nie zwraca.
Czy mogę pobrać posty innego konta?
Nie z media edge, który odczytuje konto powiązane z tokenem. Business Discovery zwraca posty innej firmy lub konta twórcy przy logowaniu przez Facebook Login lub Unified Login.
Dlaczego stary media_url przestał działać?
Adresy CDN Meta są zabezpieczone prywatnością: przestają zwracać media po usunięciu lub wygaśnięciu treści, więc w razie potrzeby pobieraj aktualne adresy.
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