登入開始免費試用
easyCoexistence 官方 API

透過 API 取得 Instagram 帳戶的貼文

GET /<IG_ID>/media 會以 IG Media 物件回傳 Instagram 專業帳戶的貼文,最多可取得最近建立的 10,000 則。可要求 id、media_type、media_url、permalink、thumbnail_url 與 timestamp 等欄位,並透過 children 讀取輪播的項目。回應附有 before 與 after 游標以供分頁,而 since 與 until 可按日期限制範圍。使用 Instagram Login 時,請求須發送至 graph.instagram.com。

easyCoexistence 可透過 list_social_posts 列出已連接 Instagram 帳戶的貼文,每次 1 至 100 則,可由 Claude、ChatGPT 或您自己的程式呼叫,並透過 Meta 官方 API 附上權杖。

10,000

依 Meta 的 IG User Media 參考,media 端點最多回傳最近建立的媒體數目。

since, until

media 端點的時間分頁參數,接受 Unix 時間戳或 strtotime 值。

/stories

限時動態媒體的讀取方式:media 端點不會回傳限時動態媒體。

VIDEO only

會回傳 thumbnail_url(媒體縮圖網址)的媒體類型。

Optional

Meta 對 media_url 的處理方式:部分影片會省略此欄位,此時應改用 permalink 或 thumbnail_url。

如何取得帳戶的貼文?

對帳戶的 media 端點發出 GET,並列明要回傳的欄位;若未指定 fields,Meta 的範例只會回傳每則貼文的 id。使用 Instagram Login 時,請求發送至 graph.instagram.com,並須附上具備 instagram_business_basic 權限的 Instagram 使用者存取權杖。回應會將貼文列於 data,並附上 paging 物件以取得下一頁。

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>"
  }
}

每則貼文可回傳哪些欄位?

IG Media 物件的所有欄位,詳見 Meta 參考文件;請只要求實際會用到的欄位。該參考中有兩列(caption 與 media_product_type)註明「僅適用於搭配 Facebook Login 的 Instagram API」,因此在依賴它們之前,請先核對您的設定:

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

分頁如何運作?

以游標分頁。paging 物件包含 before 與 after 游標,當仍有更多結果時,還會附上 next 網址。Meta 的 Graph API 指南指出,當 next 不再出現時即停止,因為單頁項目數可能少於 limit 所要求的數量。media 端點亦可按時間分頁:since 與 until 接受 Unix 時間戳或 strtotime 值,並將結果限定於該範圍內。

如何讀取輪播中的相片與影片?

透過 children 端點。media_type 為 CAROUSEL_ALBUM 的貼文,可使用與 media 端點相同的權杖與權限,發出 GET /<IG_MEDIA_ID>/children 以列出其項目;每個項目都是一個 IG Media 物件,具有自己的 id、media_type 與 media_url。Meta 指出,相簿內的相片無法使用部分欄位,其中包括 permalink。

A carousel's items
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
  ?fields=id,media_type,media_url
  &access_token=<ACCESS_TOKEN>

為何部分貼文缺少 media_url?

Meta 會在包含受版權保護或已授權音訊的影片媒體中省略此欄位,包括 Instagram 音訊庫中的曲目;被標記為違反版權的媒體亦然,即使是帳戶自己的貼文也一樣。其參考文件指出,應將 media_url 視為選填,並改用 permalink 或 thumbnail_url 作為備選。直播影片只能在直播進行期間讀取。

如何在網站上展示貼文?

從您的伺服器端,使用帳戶的長效權杖(效期 60 天,須於到期前更新)取得資料。將每個方塊連結至其 permalink,並按排程重新整理清單:Meta 透過具隱私感知能力的 CDN 網址提供媒體,而這些網址在內容被刪除或過期後便不再回傳檔案。若要按 Instagram 的原樣呈現某則貼文,請改將其 permalink 傳送至 oEmbed 端點。

如何透過 easyCoexistence 列出貼文?

使用 list_social_posts,其接受 account_id 與介於 1 至 100 之間的 limit(預設為 25),並回傳帳戶近期貼文的 ID、媒體類型、媒體網址、縮圖、permalink、時間戳,以及讚好數與留言數。它讀取最近的貼文,最多 100 則,沒有游標可取得更多分頁或其他欄位。

常見錯誤

  • 在 media 端點中尋找限時動態。Meta 不會將其納入;GET /<IG_ID>/stories 會在限時動態存續的 24 小時內將其回傳。
  • 只以 media_url 建立動態牆。Meta 會為部分影片省略此欄位,因此請保留 permalink 或 thumbnail_url 作為備選。
  • 要求輪播項目的 permalink。Meta 不會為相簿內的相片回傳此欄位,因此請連結至上層貼文。
  • 將短頁視為最後一頁。單頁項目數可能少於 limit;只有在分頁已無 next 時才停止。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,隨連接數目增加降至 US$ 0.75,並提供首 3 天免費試用。

常見問題

Instagram API 最多可回傳多少則貼文?

最多 10,000 則(最近建立者優先),從 media 端點每次取得一頁。限時動態則於其存續期間,由獨立的 stories 端點提供。

media 端點是否包括 Reels?

包括。Reel 與相片一樣是 IG Media 物件,以 media_type VIDEO 回報;media 端點不包括的是限時動態。

我可以取得其他帳戶的貼文嗎?

無法透過 media 端點取得,該端點只讀取權杖所屬的帳戶。Business Discovery 可回傳其他商業或創作者帳戶的貼文,需使用 Facebook Login 或 Unified Login。

為何舊的 media_url 失效了?

Meta 的 CDN 網址具隱私感知能力:內容被刪除或過期後,它們便不再回傳媒體,因此需要時請重新索取目前的網址。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期