這份文件已更新。
中文(台灣) 的翻譯尚未完成。
英文更新時間:9月4日
中文(台灣) 更新時間:2022年8月1日

Changelog

September 4, 2024

Announcing deprecation of Instagram Basic Display API. In 90 days, on December 4, 2024, the Instagram Basic Display API will no longer be available.

June 28, 2022

Reels

適用於所有版本。

GET /{user-id}/media 回應現在包含影片 Reels,但是目前沒有方法可以判斷系統是否已將回應集合中指定的影片指派為連續短片。

June 27, 2022

舊版 Instagram API 文件

適用於所有版本。

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

August 30, 2021

Facebook 站外動態

適用於所有版本。

與清除紀錄和後續動態設定相關的 2021 年 6 月 15 日變更曾在 7 月中旬暫停,但現在已恢復。

June 30, 2021

私密帳號存取權杖

適用於所有版本。

私密 Instagram 帳號的長期存取權杖現在可以重新整理。此外,擁有私密帳號的應用程式用戶所授予應用程式的權限,現在有效期為 90 天。

June 15, 2021

Facebook 站外動態

適用於所有版本。

用戶若清除紀錄或關閉未來動態,將會讓存取權杖失效。此外,系統將會提示已關閉未來動態的用戶和嘗試使用授權視窗的用戶開啟未來動態,以使用您的應用程式。

June 8, 2021

Access Token Debugger

Applies to all versions.

The access token debugger tool now only returns an app-scoped ID when debugging a token.


API Versioning

Applies to all versions.

The API now supports versioned calls. To query a specific API version include the version number in the query path after the base URL. For example:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Un-versioned requests (missing the version number) resolve to the version specified in the calling app's App Dashboard > Settings > Advanced > Upgrade API Version section.


App Scoped User IDs

Applies to version 11.0+.

App-scoped user IDs (ASIDs) have been introduced. ASIDs will replace raw user IDs in approximately two years, when version 10.0 is deprecated, so we recommend that you begin mapping your app users' raw IDs to their ASID equivalents.

  • All versions support raw user ID based queries.
  • Only version 11.0+ calls support ASID based queries.
  • Version 11.0+ calls will receive ASIDs in responses, even when querying raw user IDs.

Time-based Pagination

Applies to v11.0+.

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

October 24, 2020

  • User Node — The ig_id field, which returned the app user's Instagram Legacy User ID, has been deprecated.

August 31, 2020

June 5, 2020

  • Legacy IDs — You can now request the ig_id field on the User node to get the app user's Instagram Legacy API User ID. This field will be available until September 30th, 2020. (UPDATE: Available until October 24, 2020).

February 20, 2020

January 14, 2020

December 6, 2019

October 15, 2019

Instagram Basic Display API has officially launched!