文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:9月4日
中文(简体) 更新时间:2022年7月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 视频,但是,目前无法确定是否已将响应集中的给定视频指定为 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!