Instagram 开放平台

Instagram 开放平台更新日志

此更新日志介绍针对 Instagram API 做出的更新。

相关更新日志

2024 年 10 月 3 日

欢迎消息流程现在可用于包含 Instagram 业务账户关联登录的 Instagram API。详细了解。

2024 年 10 月 2 日

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

2024 年 9 月 17 日

新增了多个 scope 值

适用于所有版本。

为确保 scope 值与权限名称之间的一致性，我们为包含 Instagram 账户关联登录的 Instagram API 引入了新的 scope 值。scope 新值如下：

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

这些值将分别替换以下现有值：business_basic、business_content_publish、business_manage_comments 和 business_manage_messages。

请注意，scope 旧值将于 2025 年 1 月 27 日停用。在此日期之前更新您的代码非常重要，以免应用功能受到任何破坏。如未更新代码，您的应用将无法调用 Instagram 端点。

更正：停用日期从 2024 年 12 月 17 日变更为 2025 年 1 月 27 日。

2024 年 7 月 23 日

发布了包含 Instagram 业务账户关联登录的全新 Instagram API

该新 Instagram API 的组件：

  • 将不再需要 Facebook 公共主页
  • 用于 API 调用的主机网址是 graph.instagram.com
  • 使用此 API 所需的新权限如下：
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • Messenger API 将不再用于发送 Instagram 消息
  • 创建 Meta 应用时，新应用中将添加该新 Instagram 产品
  • 现有应用可在应用面板中添加该新 Instagram 产品

如要了解该包含 Instagram 业务账户关联登录的新 Instagram API 是否适合您，请访问我们的迁移指南。

2024 年 6 月 11 日

Instagram 评论 Webhooks

适用于所有版本。

用户评论速推的 Instagram 帖子或 Instagram 广告帖时，comments 字段内 value 对象的 media 对象中将返回 ad_id 和 ad_title 以及 original_media_id。详情请参阅设置 Instagram 专用 Webhooks。

2024 年 5 月 21 日

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

2023 年 9 月 12 日

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

2022 年 11 月 9 日

Instagram Webhooks

适用于所有版本。

用户评论速推的 Instagram 帖子或 Instagram 广告帖时，comments 字段内 value 对象的 media 对象中将返回 ad_id 和 ad_title。

10 月 31 日

Reels – 商品标记

适用于所有版本。

Instagram Reels 产品标记 API 现已推出。发布 Reels 时，您最多可标记 30 件商品。

2022 年 6 月 28 日

Reels

适用于所有版本。

现已支持 Reels。如要将视频发布为 Reels，请在创建单一媒体帖子容器时，将 media_type 参数设置为 REELS。请参阅 POST /ig-user/media endpoint 参考文档，了解哪些参数可用于 Reels，以及 Reels 类视频有哪些相关要求。

2022 年 6 月 27 日

旧版 Instagram API 文档

适用于所有版本。

旧版 Instagram API 开发者文档已被移除，现将跳转到 Instagram 开放平台开发者文档。

2022 年 6 月 20 日

商品标记

适用于所有版本。

现在您可以在 Instagram 业务帐户的已发布媒体上创建和管理 Instagram 购物商品标记。请参阅商品标记指南，了解具体方法。

2022 年 5 月 27 日

商品款式

适用于所有版本。

若合作伙伴正在使用商品标记测试版，在搜索商品目录时，系统现在会返回符合查询搜索条件的所有商品款式。

2022 年 3 月 15 日

轮播帖子

适用于所有版本。

您现在可以使用 Instagram API 发布包含多张图片和多段视频的帖子（轮播帖子）。请参阅内容发布指南，查看完整的发布步骤。

如果您的应用已获准使用发布内容所需的权限，则无需再通过应用审核即可使用此功能。

2021 年 11 月 9 日

直播视频

适用于所有版本。

您现在可以使用 Instagram API 获取应用用户正在直播的直播视频 Instagram 媒体、获取视频评论，并可使用 Instagram Messaging API 向评论作者发送私信回复（Direct 消息）。为支持此功能，已进行以下更改：

  • 系统发出请求时，全新 GET /ig-user/live_media 连线可以返回您的应用用户正在直播的直播视频 Instagram 媒体
  • Instagram 评论的 media 字段现在会返回一个对象，其中包含受到评论的媒体的编号 (id) 及发布位置 (media_product_type)
  • 在您的应用用户的直播视频正在播放时，全新 live_comments Instagram Webhooks 字段可以发送包含实时评论的通知

请参考 Instagram Messaging API 私信回复文档，了解如何向对您的应用用户直播视频 Instagram 媒体发表评论的用户发送私信回复。

2021 年 10 月 20 日

Instagram 评论

适用于所有版本。

两个新字段已添加到 Instagram 评论：

  • from — 返回对象包括评论创作者的 IGSID (id) 和帐号 (username)。
  • parent_id — 如果该评论以另一条 Instagram 评论为基础进行创建（即对另一条评论的回复），则返回父 Instagram 评论编号。

Instagram Webhooks

适用于所有版本。

comments Instagram Webhooks 字段现在在 value 字段对象中包含以下属性：

  • from.id — 创建评论的 Instagram 用户的 IGSID。
  • from.username — 创建评论的 Instagram 用户的帐号
  • media.id — 受到评论的 Instagram 媒体的编号。
  • media.media_product_type — 受到评论的 Instagram 媒体平台（发表位置）。
  • parent_id — 如果该评论以另一条 Instagram 评论为基础进行创建（即对另一条评论的回复），则为父 Instagram 评论编号。

2021 年 10 月 5 日

以下更改适用于 2021 年 10 月 5 日或之后创建的 Instagram TV 视频。在此日期之前创建的 Instagram TV 视频不受这些更改的影响。

  • media_product_type字段将返回 FEED，而不是 IGTV
  • 系统将不会返回 video_title字段
  • 现已支持 Instagram Webhookscomments 和 mentions 字段

2022 年 1 月 3 日，上述更改将适用于所有 API 版本和所有 Instagram TV 视频（适用于任意创建日期的视频）。这意味着从 2022 年 1 月 3 日开始，使用旧 API 版本的应用将能够查询 Instagram TV 视频（读取支持在 v10.0 中引入，仅限于 v10.0 及以上版本）。

从 14.0 版本起，将不再支持 video_title 字段。如果请求该字段，API 将抛出错误。

2021 年 6 月 8 日

获赞数

适用于 11.0 及以上版本。将从 2021 年 9 月 7 日起适用于所有版本。

如果通过另一个端点或字段扩展间接查询 Instagram 媒体，则在媒体所有者已隐藏获赞数的情况下，API 响应将忽略 like_count 字段。若是直接查询 Instagram 媒体（只能由 Instagram 媒体所有者实施），则即使所有者已隐藏获赞数，系统仍会返回实际的获赞数。


基于时间的分页

适用于 11.0 及以上版本。

已向 since 端点添加 until 和 GET /{ig-user-id}/media 参数，以支持基于时间的分页。

2021 年 5 月 26 日

如果应用用户不是媒体所有者并且媒体所有者已隐藏获赞数，则通过另一个端点间接查询 Instagram 媒体，like_count 字段现在会返回 0。若是直接查询 Instagram 媒体（只能由 Instagram 媒体所有者进行），则即使所有者已隐藏获赞数，系统仍会返回实际的获赞数。

2021 年 5 月 4 日

对 Instagram 用户 online_followers 指标的计算方式做出了一些微小的更改。

2021 年 4 月 14 日

日本用户的快拍 Instagram 媒体互动不再包含在有些 replies 指标的计算中：

  • 对于日本用户创作的快拍，replies 指标现在将返回 0 值。
  • 对于日本以外地区的用户创作的快拍，replies 指标将返回回复次数，但计算结果中不会包含日本用户作出的回复。

2021 年 4 月 12 日

修复了快拍 Instagram 媒体覆盖人数指标的小漏洞。

2021 年 4 月 9 日

2021 年 3 月 16 日

10.0 及以上版本现已支持 IGTV 媒体。这适用于所有端点，用于内容发布和 Webhooks 的端点除外。为支持此更改，已向 Instagram 媒体节点添加新的 media_product_type 和 video_title 字段。发布内容时必须已将 IGTV 媒体分享至 Instagram（已启用发布预览或把预览分享到快拍），才能通过 API 加以访问。

2021 年 1 月 26 日

内容发布测试已结束，所有开发者现在均可以在 Instagram 专业帐户中发布媒体。请参阅内容发布指南，了解使用详情。

2020 年 12 月 2 日

根据欧盟的《电子隐私指令》(ePrivacy Directive)，在 2020 年 12 月 1 日以后，欧洲经济区 (EEA) 用户执行的与消息相关的快拍 Instagram 媒体互动将不再包含在某些指标计算中：

  • 对于 EEA 用户创建的快拍，replies 指标现在将返回 0 值。
  • 对于 EEA 以外地区的用户创建的快拍，replies 指标将返回回复次数，但不会将 EEA 用户作出的回复计算在内。

此更改适用于所有版本。

2020 年 11 月 10 日

  • Instagram 用户成效分析 — follower_count 值现在会更及时地与 Instagram 应用中显示的相应值进行同步。此外，follower_count 现在最多返回 30 天而非 2 年内的数据。此更改适用于 9.0 及以上版本，且自 2021 年 5 月 9 日起适用于所有版本。

2020 年 5 月 5 日

2019 年 12 月 3 日

  • 成效分析 — 为了让 API 与 Instagram 应用行为保持一致，针对 Instagram 用户的成效分析现在仅适用于粉丝数不少于 100 位的 Instagram 用户。

2019 年 8 月 13 日

  • 商家发现 — 商家发现 API 现在可用于获取关于其他 Instagram 创作者帐户的数据。

2019 年 5 月 22 日

2019 年 5 月 9 日

  • Webhooks — story_insights 字段现在需要 instagram_manage_insights 权限而非 instagram_manage_comments 权限。

2018 年 10 月 31 日

  • 话题标签搜索 API — 您现在可以使用我们的全新话题标签搜索 API 搜索使用特定话题标签标记的媒体。#spooky！

2018 年 10 月 23 日

  • /{ig-media-id}/comments 连线 — 使用 API 版本 3.1 或更低版本发出的 GET 请求将以时间顺序返回结果。使用版本 3.2 及以上版本发出的请求将以时间倒序返回结果。

2018 年 6 月 7 日

  • /{ig-media-id} 节点 — 您现在可以使用字段扩展获取媒体对象的 permalink 字段。

2018 年 5 月 1 日

  • 公司验证 — 要使用 Instagram 图谱 API，所有应用都必须接受公司验证，这是应用审核流程的一部分，并且现在也是所有 Instagram 图谱 API 端点的要求。在 2018 年 5 月 1 日前经过审核的应用需于 2018 年 8 月 1 日前再次进行审核，否则会失去此访问 API 的权限。

2018 年 4 月 24 日

  • /{ig-comment-id} 节点：
    • 添加了新的 username 字段。
    • 对于 GET 请求，除非提出请求的用户是评论的所有者，否则响应中不会包含 user 字段，而是包含所有评论者的 username。这也适用于通过其他 API 作出的评论查询，例如提及 API。
  • /{ig-media-id} 节点：
    • 添加了新的 username 字段。
    • 对于 GET 请求，除非提出请求的用户是媒体对象的所有者，否则响应中不会包含 owner 字段，而是包含所有评论者的 username。这也适用于通过其他 API 作出的媒体对象查询，例如提及 API。

2018 年 4 月 23 日

  • 成效分析 API — 成效分析现在将包含通过此 API、Facebook 广告界面和 Instagram 的推广功能生成的广告活动。这会影响以下指标：

    • impressions
    • reach

2018 年 3 月 13 日

  • 内容发布 API — 参与公测的合作伙伴现可在发布照片时，使用 /{ig-user-id}/media 连线标记地点和公开 Instagram 用户。

2018 年 3 月 8 日

  • 公开字段 — /{ig-media-id} 节点的 timestamp 字段现在属于公开字段，可以通过字段扩展返回。

2018 年 2 月 22 日

  • 公开字段 — 使用字段扩展通过连线进行访问时，/{ig-user-id}、/{ig-comment-id} 和 /{ig-media-id} 节点现在会返回所有公开字段。请参阅每个节点的参考文档，了解哪些字段是公开字段。

2018 年 2 月 8 日

  • 内容发布 API — 参与公测的合作伙伴现可在发布照片时，通过 /{ig-user-id}/media 连线在其中加入话题标签。#crazywildebeest 棒极了！