通过 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 自动附加令牌。
媒体边缘最多返回的最近创建的媒体数量,依据 Meta 的 IG User Media 参考文档。
媒体边缘基于时间的分页参数,接受 Unix 时间戳或 strtotime 值。
Stories 的读取方式:媒体边缘不返回 Story 媒体。
返回 thumbnail_url 的媒体类型,即媒体缩略图的 URL。
Meta 对 media_url 的处理方式:对部分视频会省略该字段,此时应回退至 permalink 或 thumbnail_url。
如何获取账户的帖子?
对账户的媒体边缘发送 GET 请求,并指定要返回的字段。若不指定 fields,Meta 的示例只返回每条帖子的 id。使用 Instagram Login 时,请求发送至 graph.instagram.com,并使用包含 instagram_business_basic 权限的 Instagram 用户访问令牌。响应在 data 中列出帖子,并附带用于下一页的 paging 对象。
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,因此在依赖它们之前,请先对照你的配置进行核对:
分页如何工作?
使用游标分页。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)无法用于相册中的照片。
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 时才应停止。
每个连接每月 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 监控
验证时间