Instagram 開放平台
返回中文(台灣)
這份文件已更新。
中文(台灣) 的翻譯尚未完成。
英文更新時間：6月12日
中文(台灣) 更新時間：6月11日

Changelog

This changelog refers to changes made for the Instagram Graph API.

Related Changelogs

June 11, 2024

Instagram Comment Webhooks

Applies to all versions

In addition to the ad_id and ad_title, the original_media_id will be returned in the media object of the comments field's value object when a person comments on a boosted Instagram post or Instagram ads post. For more information, refer to Set Up Webhooks for Instagram.

May 21, 2024

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:

September 12, 2023

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.

November 9, 2022

Instagram Webhooks

Applies to all versions.

The ad_id and ad_title will be returned in the media object of the comments field's value object when a person comments on a boosted Instagram post or Instagram ads post.

October 31st

Reels – Product Tags

Applies to all versions.

Instagram Product Tagging API for Reels is made available. You can tag up to 30 products when publishing a reel.

June 28, 2022

Reels

Applies to all versions.

Reels are now supported. To publish a video as a reel, set the media_type parameter to REELS when creating a single media post container. Refer to the POST /ig-user/media endpoint reference to learn which parameters can be used with reels as well as requirements for reels videos.

Note: Beginning November 9, 2023, the VIDEO value for media_type will no longer be supported. Use the REELS media type to publish a video to your feed.

June 27, 2022

舊版 Instagram API 文件

適用於所有版本。

舊版 Instagram API 開發人員文件已移除，系統現在會重新導向至 Instagram 開放平台開發人員文件。

June 20, 2022

商品標註

適用於所有版本。

您現在可以在 Instagram 商業帳號發佈的影音素材上建立及管理 Instagram 購物商店標籤。若要瞭解操作方式，請參閱商品標註指南。

May 27, 2022

Product Variants

Applies to all versions.

For partners in the Product Tagging beta, all product variants that match a query's search criteria will now be returned when searching a catalog for products.

March 15, 2022

輪播廣告貼文

適用於所有版本。

您現在可以使用 Instagram API 發佈包含多個圖像和影片的貼文（輪播廣告貼文）。如需完整的發佈步驟，請參閱內容發佈指南。

如果您的應用程式已獲准取得內容發佈所需的權限，則無需再次進行應用程式審查即可使用此功能。

November 9, 2021

直播影片

適用於所有版本。

現在，您可以使用 Instagram API 取得應用程式用戶直播中的直播影片 IG 影音素材、取得這些影片的留言，以及使用 Instagram 傳訊 API 傳送私密回覆（direct 訊息）給留言作者。為了支援此功能，系統已進行以下變更：

  • 新的 GET /ig-user/live_media 關係連線可以傳回應用程式用戶要求時直播的直播影片 IG 影音素材
  • IG 留言的 media 欄位現在會回傳，以及同時包含留言發表處所在影音素材的編號（id）和發佈位置（media_product_type）的物件
  • 新的 live_comments Instagram Webhooks 欄位可傳送通知，該通知包含應用程式用戶的直播影片在直播時的直播留言

請參閱 Instagram 傳訊 API 私密回覆文件，瞭解如何傳送私密回覆給已對應用程式用戶的直播影片 IG 影音素材發表留言的用戶。

October 20, 2021

IG 留言

適用於所有版本。

IG 留言中已新增兩個新欄位：

  • from - 傳回包含留言建立者之 IGSID（id）和用戶名稱（username）的物件。
  • parent_id - 若此留言建立在另一個 IG 留言上（即回覆另一個留言），則傳回父系 IG 留言的編號。

Instagram Webhooks

適用於所有版本。

comments Instagram Webhooks 欄位現在包含下列 value 欄位物件中的屬性：

  • from.id - 建立留言之 Instagram 用戶的 IGSID。
  • from.username - 建立留言之 Instagram 用戶的用戶名稱
  • media.id - 留言發表處所在 IG 影音素材的編號。
  • media.media_product_type - 留言發表處所在 IG 影音素材的介面（發佈位置）。
  • parent_id - 若此留言建立在另一個 IG 留言上（即回覆另一個留言），則為父系 IG 留言的編號。

October 5, 2021

下列變更適用於 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 影片（讀取支援於第 10.0 版中推出，並僅限於 10.0 以上版本使用）。

從第 14.0 版開始，系統將不再支援 video_title 欄位，如果要求該欄位，API 將擲回錯誤。

June 8, 2021

Like Counts

Applies to v11.0+. Will apply to all versions September 7, 2021.

If indirectly querying an IG Media through another endpoint or field expansion, the like_count field will be omitted from API responses if the media owner has hidden like counts on it. Directly querying the IG Media (which can only be done by the IG Media owner) will return the actual like count, however, even if like counts have been hidden.


Time-based Pagination

Applies to v11.0+.

Added since and until parameters to the GET /{ig-user-id}/media endpoint to support time-based pagination.

May 26, 2021

現在開始，如透過另一個端點間接查詢 IG 影音內容，like_count 欄位遇到下列情況時會傳回 0：若應用程式用戶並未擁有該影音內容，且影音內容擁有者已隱藏按讚數。只有 IG 影音內容擁有者能直接查詢 IG 影音內容，即使擁有者已隱藏影音內容的按讚數，這樣的查詢方式仍會傳回實際按讚數。

May 4, 2021

針對 IG 用戶的 online_followers 衡量指標計算方式進行微幅變更。

April 14, 2021

日本用戶所進行的限時動態 IG 媒體互動，不再包含於部分 replies 衡量指標計算中：

  • 若是日本用戶所建立的限時動態，replies 衡量指標現在將傳回 0 值。
  • 若是日本以外的用戶所建立的限時動態，replies 衡量指標將傳回回覆次數，但日本用戶所進行的回覆將不會包括在計算中。

April 12, 2021

Fixed a minor bug with reach metrics on story IG Media.

April 9, 2021

  • 如果 IG 容器的 error_code 欄位值為 ERROR，容器的 status 欄位現在會傳回錯誤子代碼。
  • IG 媒體洞察報告 video_views 衡量指標現在支援相簿，將傳回相簿中所有影片的 video_views 總和，而不是 0。

March 16, 2021

IGTV media is now supported in v10.0+. This applies to all endpoints except those used for content publishing and webhooks. To support this change, new media_product_type and video_title fields have been added to the IG Media node. IGTV media must have been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled) in order to be accessible via the API.

Januray 26, 2021

The Content Publishing beta has ended and all developers can now publish media on Instagram Professional accounts. Refer to the Content Publishing guide for usage details.

December 2, 2020

In compliance with the European Union's ePrivacy Directive, messaging-related Story IG Media interactions performed by users in the European Economic Area (EEA) after December 1, 2020, will no longer be included in some metric calculations:

  • For Stories created by users in the EEA, the replies metric will now return a value of 0.
  • For Stories created by users outside the EEA, the replies metric will return the number of replies, but replies made my users in the EEA will not be included in its calculation.

This change applies to all versions.

November 10, 2020

  • IG User Insights — The follower_count values now align more closely with their corresponding values displayed in the Instagram app. In addition, follower_count now returns a maximum of 30 days of data instead of 2 years. This change applies to v9.0+ and will apply to all versions May 9, 2021.

May 5, 2020

December 3, 2019

  • Insights — To align API behavior with Instagram app behavior, insights on IG Users are now only available on IG Users that have 100 or more followers.

August 13, 2019

  • Business Discovery — The Business Discovery API can now be used to get data about other Instagram Creator accounts.

May 22, 2019

May 9, 2019

  • Webhooks — The story_insights field now requires the instagram_manage_insights permission instead of instagram_manage_comments.

October 31, 2018

  • Hashtag Search API — You can now search for media tagged with specific hashtags by using our new Hashtag Search API. #spooky!

October 23, 2018

  • /{ig-media-id}/comments edge — GET requests made using API version 3.1 or older will have results returned in chronological order. Requests made using version 3.2+ will have results returned in reverse chronological order.

June 7, 2018

  • /{ig-media-id} node — You can now use field expansion to get the permalink field on media objects.

May 1, 2018

  • Business Verification — In order to use the Instagram Graph API, all apps must undergo Business Verification, which is part of the App Review process and now required for all Instagram Graph API endpoints. Apps previously reviewed before May 1st, 2018, have to be reviewed again, and have until August 1st, 2018 to do so, or lose access to the API.

April 24, 2018

  • /{ig-comment-id} node:
    • Added a new username field.
    • For GET requests, the user field will not be included in responses unless the User making the request owns the Comment; instead, we will return username for all commenters. This also applies to queries on Comments made through other APIs, such as the Mentions API.
  • /{ig-media-id} node:
    • Added a new username field.
    • For GET requests, the owner field will not be included in responses unless the User making the request owns the media object; instead, we will return username for all commenters. This also applies to queries on media objects made through other APIs, such as the Mentions API.

April 23, 2018

  • Insights API — Insights will now include ad activity generated through the API, Facebook ads interfaces, and Instagram's Promote feature. This affects the following metrics:

    • impressions
    • reach

March 13, 2018

  • Content Publishing API — Beta partners can now use the /{ig-user-id}/media edge to tag locations and public Instagram users when publishing photos.

March 8, 2018

  • Public fields — The timestamp field on the /{ig-media-id} node is now a public field and can be returned via field expansion.

February 22, 2018

  • Public fields — The /{ig-user-id}, /{ig-comment-id}, and /{ig-media-id} nodes will now return all public fields when accessed through an edge via field expansion. Refer to each node's reference document to see which fields are public.

February 8, 2018

  • Content Publishing API — Beta partners can now include hashtags when publishing photos via the /{ig-user-id}/media edge. #crazywildebeest FTW!