登录开始免费试用
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 参考文档。

since, until

媒体边缘基于时间的分页参数,接受 Unix 时间戳或 strtotime 值。

/stories

Stories 的读取方式:媒体边缘不返回 Story 媒体。

VIDEO only

返回 thumbnail_url 的媒体类型,即媒体缩略图的 URL。

Optional

Meta 对 media_url 的处理方式:对部分视频会省略该字段,此时应回退至 permalink 或 thumbnail_url。

如何获取账户的帖子?

对账户的媒体边缘发送 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)的末尾注明 Available for Instagram API with Facebook Login only,因此在依赖它们之前,请先对照你的配置进行核对:

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 URL。Meta 的 Graph API 指南指出,当 next 不再出现时即应停止,因为一页返回的条目数可能少于 limit 所请求的数量。媒体边缘也支持按时间分页:since 和 until 接受 Unix 时间戳或 strtotime 值,并将结果限定在该时间范围内。

如何读取轮播的照片和视频?

通过 children 边缘。media_type 为 CAROUSEL_ALBUM 的帖子,可使用 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?

对于包含受版权保护或已获授权音频的视频媒体(包括来自 Instagram 音频库的曲目),Meta 会省略该字段;对于被标记为侵犯版权的媒体,同样会省略,账户自己的帖子亦然。Meta 的参考文档指出,应将 media_url 视为可选字段,并回退至 permalink 或 thumbnail_url。Instagram Live 视频仅可在直播期间读取。

如何在网站上展示帖子?

请在你的服务器端,使用账户的长期令牌进行操作。该令牌有效期为 60 天,须在过期前刷新。将每个图块链接到其 permalink,并定期刷新列表:Meta 通过注重隐私的 CDN URL 提供媒体,一旦内容被删除或过期,这些 URL 便不再返回文件。若要按 Instagram 的原样显示某条帖子,请改为将其 permalink 传递给 oEmbed 端点。

如何通过 easyCoexistence 列出帖子?

使用 list_social_posts,它接受 account_id 以及 1 至 100 之间的 limit(默认为 25),并返回该账户的近期帖子,包括其 ID、媒体类型、媒体 URL、缩略图、permalink、时间戳,以及点赞数和评论数。它读取最近的帖子,最多 100 条,不提供用于获取更多页面或其他字段的游标。

常见错误

  • 在媒体边缘中查找 Stories。Meta 不会返回它们,GET /<IG_ID>/stories 则会在 Stories 存续的 24 小时内返回。
  • 仅以 media_url 构建动态流。Meta 对部分视频会省略该字段,因此应保留 permalink 或 thumbnail_url 作为回退。
  • 对轮播条目请求 permalink。Meta 不会为相册中的照片返回该字段,因此应链接到父帖子。
  • 将不满一页的结果视为最后一页。一页返回的条目数可能少于 limit,只有在分页不再有 next 时才应停止。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 至 US$ 0.75,连接越多单价越低,前 3 天免费。

常见问题

Instagram API 最多能返回多少条帖子?

最多返回最近创建的 10,000 条,从媒体边缘每次返回一页。Stories 则从单独的 stories 边缘获取,且仅在其存续期间可读取。

媒体边缘包含 Reels 吗?

包含。Reel 与照片一样是一个 IG Media 对象,以 media_type VIDEO 返回。媒体边缘不返回的是 Stories。

能获取其他账户的帖子吗?

媒体边缘无法做到,它只读取令牌所属的账户。Business Discovery 则可借助 Facebook Login 或 Unified Login,返回其他企业或创作者账户的帖子。

为何旧的 media_url 失效了?

Meta 的 CDN URL 注重隐私:一旦内容被删除或过期,它们便不再返回媒体,因此需要时请获取最新的 URL。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间