This changelog refers to changes made for the Instagram APIs.
scope
valuesApplies to all versions.
To ensure consistency between scope
values and permission names, we are introducing new scope
values for the Instagram API with Instagram login. The new scope
values are:
instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
These will replace the existing business_basic
, business_content_publishing
, business_manage_comments
and business_manage_messages
values, respectively.
Please note that the old scope
values will be deprecated on December 17, 2024. It is essential to update your code before this date to avoid any disruption in your app's functionality. Failure to do so will result in your app being unable to call the Instagram endpoints.
Components of this new Instagram API:
graph.instagram.com
instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Visit our migration guide to learn if this new Instagram API with Instagram Login is right for you.
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.
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:
GET /{ig-user-id}/insights
engaged_audience_demographics
reached_audience_demographics
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.
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.
Applies to all versions.
Instagram Product Tagging API for Reels is made available. You can tag up to 30 products when publishing a reel.
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.
มีผลกับทุกเวอร์ชั่น
เราได้ลบเอกสารประกอบสำหรับผู้พัฒนาเกี่ยวกับ Instagram API แบบเดิมออกแล้ว และตอนนี้ระบบจะเปลี่ยนเส้นทางไปยังเอกสารประกอบสำหรับผู้พัฒนาเกี่ยวกับแพลตฟอร์ม Instagram แทน
มีผลกับทุกเวอร์ชั่น
คุณสามารถสร้างและจัดการแท็กสินค้า Instagram Shopping ในสื่อที่เผยแพร่ของ Instagram Business ได้แล้วตอนนี้ เรียนรู้วิธีในคู่มือการแท็กสินค้า
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.
ใช้ได้กับทุกเวอร์ชั่น
ในตอนนี้ คุณสามารถใช้ Instagram API เพื่อเผยแพร่โพสต์ที่มีรูปภาพและวิดีโอหลายรายการได้แล้ว (โพสต์ภาพสไลด์) โปรดดูขั้นตอนการเผยแพร่ฉบับสมบูรณ์ในคู่มือการเผยแพร่เนื้อหา
หากแอพของคุณได้รับการอนุมัติสิทธิ์การอนุญาตที่จำเป็นต่อการเผยแพร่เนื้อหามาก่อนแล้ว คุณก็ไม่ต้องนำเนื้อหาเข้าสู่กระบวนการตรวจสอบแอพอีกครั้ง และสามารถใช้ประโยชน์จากฟังก์ชั่นการทำงานนี้ได้เลย
มีผลกับทุกเวอร์ชั่น
ในตอนนี้คุณสามารถใช้ API ของ Instagram เพื่อรับสื่อบน IG ที่เป็นวิดีโอถ่ายทอดสดที่แพร่ภาพโดยผู้ใช้แอพของคุณ รับความคิดเห็นในวิดีโอเหล่านั้น และใช้ API การส่งข้อความบน Instagram เพื่อส่งข้อความตอบกลับแบบส่วนตัว (DM) ไปยังผู้เขียนความคิดเห็นได้ เราได้ทำการเปลี่ยนแปลงต่อไปนี้เพื่อรองรับฟังก์ชั่นการทำงานดังกล่าว
media
ในความคิดเห็นบน IG จะส่งคืนอ็อบเจ็กต์ที่มีทั้ง ID (id
) และตำแหน่งที่เผยแพร่ (media_product_type
) ของสื่อในตอนที่สร้างความคิดเห็นlive_comments
เวอร์ชั่นใหม่สามารถส่งการแจ้งเตือนที่ประกอบด้วยความคิดเห็นแบบสดในวิดีโอถ่ายทอดสดของผู้ใช้แอพของคุณในขณะที่กำลังแพร่ภาพได้โปรดดูเอกสารประกอบเกี่ยวกับข้อความตอบกลับแบบส่วนตัวของ API การส่งข้อความบน Instagram เพื่อดูวิธีการส่งข้อความตอบกลับแบบส่วนตัวไปยังผู้ใช้ที่ได้แสดงความคิดเห็นในสื่อบน IG ที่เป็นวิดีโอถ่ายทอดสดของผู้ใช้แอพของคุณ
มีผลกับทุกเวอร์ชั่น
เราได้เพิ่ม 2 ช่องใหม่ในความคิดเห็นบน IG:
from
— ส่งคืนอ็อบเจ็กต์ซึ่งประกอบด้วย IGSID (id
) และชื่อผู้ใช้ (username
) ของผู้ที่แสดงความคิดเห็นนั้นparent_id
— ส่งคืน ID ของความคิดเห็นหลักบน IG ในกรณีที่ความคิดเห็นนี้อยู่ในอีกความคิดเห็นหนึ่งบน IG (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)มีผลกับทุกเวอร์ชั่น
ในตอนนี้ ช่องcomments
ของ Webhooks สำหรับ Instagram จะมีคุณสมบัติดังต่อไปนี้ในอ็อบเจ็กต์ช่อง value
:
from.id
— IGSID ของผู้ใช้ Instagram ที่แสดงความคิดเห็นนั้นๆfrom.username
— ชื่อผู้ใช้ของผู้ใช้ Instagram ที่แสดงความคิดเห็นนั้นๆmedia.id
— ID ของสื่อบน IG ที่มีการแสดงความคิดเห็นนั้นๆmedia.media_product_type
— แพลตฟอร์ม (ตำแหน่งที่เผยแพร่) ของสื่อบน IG ที่มีการแสดงความคิดเห็นนั้นๆparent_id
— ID ของความคิดเห็นหลักบน IG ในกรณีที่ความคิดเห็นนี้อยู่ในอีกความคิดเห็นหนึ่งบน IG (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)การเปลี่ยนแปลงต่อไปนี้จะมีผลกับวิดีโอ Instagram TV ที่สร้างในหรือหลังวันที่ 5 ตุลาคม 2021 วิดีโอ Instagram TV ที่สร้างก่อนวันที่ดังกล่าวจะได้รับการยกเว้นจากการเปลี่ยนแปลงเหล่านี้
ในวันที่ 3 มกราคม 2022 การเปลี่ยนแปลงข้างต้นจะมีผลกับ API ทุกเวอร์ชั่นและวิดีโอ Instagram TV ทั้งหมด ไม่ว่าจะสร้างวิดีโอขึ้นเมื่อไรก็ตาม ซึ่งหมายความว่าตั้งแต่วันที่ 3 มกราคม 2022 เป็นต้นไป แอพที่ใช้ API เวอร์ชั่นเก่าจะสามารถสืบค้นวิดีโอ Instagram TV ได้ (การรองรับการอ่านได้เปิดตัวใน เวอร์ชั่น 10.0 และจำกัดการใช้งานเฉพาะ เวอร์ชั่น 10.0 ขึ้นไป)
ตั้งแต่เวอร์ชั่น 14.0 เป็นต้นไป ระบบจะไม่รองรับช่อง video_title
และ API จะแสดงข้อผิดพลาดหากมีการขอช่องดังกล่าว
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.
Applies to v11.0+.
Added since
and until
parameters to the GET /{ig-user-id}/media
endpoint to support time-based pagination.
หากสืบค้นสื่อบน IG ทางอ้อมผ่านตำแหน่งข้อมูลอื่น ช่อง like_count จะส่งคืน 0
ในขณะนี้ หากผู้ใช้แอพไม่ได้เป็นเจ้าของสื่อและเจ้าของสื่อได้ซ่อนจำนวนการกดถูกใจของสื่อ ส่วนการสืบค้นสื่อบน IG โดยตรงซึ่งเจ้าของสื่อบน IG เท่านั้นที่ทำได้จะส่งคืนจำนวนการกดถูกใจจริง แม้ว่าเจ้าของจะซ่อนจำนวนการกดถูกใจของสื่อก็ตาม
วิธีที่เราคำนวณเกณฑ์ชี้วัด online_followers
ของผู้ใช้ IG มีการเปลี่ยนแปลงไปเล็กน้อย
ระบบจะไม่รวมการโต้ตอบกับสื่อบน IG ที่เป็นสตอรี่โดยผู้ใช้ในประเทศญี่ปุ่นในการคำนวณเกณฑ์ชี้วัด replies
บางรายการอีกต่อไป:
replies
จะคืนค่ากลับมาเป็น 0
แล้วในตอนนี้replies
จะยังคืนค่าจำนวนการตอบกลับอยู่ แต่ระบบจะไม่รวมการตอบกลับของผู้ใช้ในประเทศญี่ปุ่นในการคำนวณด้วยFixed a minor bug with reach metrics on story IG Media.
status
บนคอนเทนเนอร์ของ Instagram จะส่งคืนรหัสย่อยของข้อผิดพลาดหากค่าในช่อง error_code
ของคอนเทนเนอร์เป็น ERROR
video_views
ข้อมูลเชิงลึกของสื่อ Instagram รองรับอัลบั้มแล้วและจะส่งคืนผลรวมของ video_views
สำหรับวิดีโอทั้งหมดในอัลบั้มแทนที่จะเป็น 0
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.
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.
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:
replies
metric will now return a value of 0
.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.
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.timestamp
field on IG Media returned by GET /{ig-hashtag-id}/top_media
and GET /{ig-hashtag-id}/recent_media
Hashtag Search queries. For example: GET /{ig-hashtag-id}/top_media?fields=timestamp
.story_insights
field now requires the instagram_manage_insights
permission instead of instagram_manage_comments
.#spooky
!/{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. /{ig-media-id}
node — You can now use field expansion to get the permalink
field on media objects./{ig-comment-id}
node:
username
field.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:
username
field.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.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
timestamp
field on the /{ig-media-id}
node is now a public field and can be returned via field expansion./{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./{ig-user-id}/media
edge. #crazywildebeest
FTW!