Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

10,000

Maksymalna liczba najnowszych mediów, jaką zwraca media edge, według referencji Meta IG User Media.

since, until

Parametry stronicowania opartego na czasie w media edge, przyjmujące znaczniki czasu Unix lub wartości strtotime.

/stories

Skąd czytać Stories: media edge nie zwraca mediów typu Story.

VIDEO only

Typ mediów, który zwraca thumbnail_url, czyli adres URL miniatury mediów.

Optional

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ę.

Listing posts with their main fields
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:

idThe media's ID
media_typeCAROUSEL_ALBUM, IMAGE or VIDEO
media_urlThe image or video file; left out for some videos
thumbnail_urlA thumbnail image, on VIDEO media only
permalinkThe post's permanent URL; not on carousel items
timestampCreation date, ISO 8601 in UTC
shortcodeThe post's shortcode
usernameThe account that created the post
comments_count, like_countCounts; like_count is left out when the owner hides likes
alt_textDescriptive text for an image
is_comment_enabledWhether comments are turned on
caption, media_product_typeMarked Facebook Login only in Meta's reference

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.

A carousel's items
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.
Z EasyCoexistence zrobisz to

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