Instagramプラットフォーム
日本語に戻す
このドキュメントが更新されました。
日本語への翻訳がまだ完了していません。
英語の最終更新: 6月18日
日本語の最終更新: 6月18日

Changelog for Instagram Platform

This changelog refers to changes made for the Instagram APIs.

Related Changelogs

June 16, 2025

Applies to all versions.

Introducing the new view_count field on the IG Media endpoint. This field is only available using the Business Discovery API for Instagram Reels.

June 14, 2025

Business Login for Instagram

Applies to all versions.

Introducing the force_reauth parameter for Business Login for Instagram. When included in the login flow, this parameter fixes the broken login experience by forcing the app user to reauthenticate even if the user is already logged into Instagram.

We recommend adding the force_reauth parameter to your app's Business Login for Instagram flow, especially if your app users log in on mobile devices.

Deprecation

Applies to all versions.

The following parameters have been deprecated for Business Login for Instagram:

  • enable_fb_login
  • force_authentication

April 8, 2025

Meta oEmbed Read Feature

Applies to all versions.

Introducing the new Meta oEmbed Read feature that is replacing the existing oEmbed Read feature. The current oEmbed Read feature will be deprecated on October 1, 2025.

  • Apps created after April 8, 2025 that implement oEmbed will use the new Meta oEmbed Read feature.
  • Existing apps that already use the current oEmbed Read feature will be automatically updated to the new Meta oEmbed Read feature by October 1, 2025.

Read the oEmbed Updates blog post from Meta to learn more.

oEmbed Response Updates

Applies to all versions.

The author_name, author_url, thumbnail_url, thumbnail_width, and thumbnail_height fields will be removed from the Facebook post, Facebook video, and Instagram post oEmbed response. The Facebook page post oEmbed endpoint will be deprecated. These changes will apply across all API versions on October 1, 2025.

March 24, 2025

Alternative text for image posts

Applies to all versions.

Introducing the new alt_text field for image posts on the /{ig-user-id}/media endpoint. Reels and stories are not supported.

January 21, 2025

Insights APIs

Applies to all versions.

Insights APIs for both media and user objects are now available for apps that have implemented Instagram API with Instagram Login.

Insights metrics

Introducing the following metrics field for media and user insights:

  • views
Metric Deprecations

Applies to v22.0+. Will apply to all versions April 21, 2025.

  • clips_replays_count on media insights
  • ig_reels_aggregated_all_plays_count on media insights
  • impressions on media and user insights
  • plays on media insights

Note: API requests with the impressions metric will continue to return data for media created on or before July 1, 2024 for v21.0 and older. API requests made after April 21, 2025 for media created on or after July 2, 2024 will return an error.

v1.0 Endpoint Deprecations

Applies to v22.0+. Will apply to all versions April 21, 2025 May 20, 2025.

The Instagram v1.0 API is deprecated.

The following endpoints are affected:

  • GET /{instagram-user-id}
  • GET /{instagram-user-id}/agencies
  • GET /{instagram-user-id}/upcoming-events
  • GET /{instagram-user-id}/authorized-adaccounts
  • POST /{instagram-user-id}/upcoming-events
  • POST /{instagram-user-id}/authorized-adaccounts
  • GET /{instagram-media-id}
  • GET /{instagram-media-id}/comments
  • GET /{instagram-carousel-id}
  • GET /{instagram-carousel-id}/comments
  • GET /{instagram-comment-id}
  • GET /{instagram-comment-id}/replies
  • POST /{instagram-media-id}/comments
  • POST /{instagram-carousel-id}/comments
  • POST /{instagram-comment-id}/replies
  • POST /{instagram-comment-id}
  • DELETE /{instagram-comment-id}
  • GET /{page-id}/instagram-accounts
  • GET /{page-id}/page-backed-instagram-accounts
  • GET /{business-id}/owned-instagram-accounts
  • GET /{business-id}/instagram-accounts
  • GET /{business-asset-group-id}/contained-instagram-accounts
  • GET /{fb-business-user-id}/assigned-instagram-accounts
  • GET /{fb-user-id}/assigned-instagram-accounts
  • GET /{fb-system-user-id}/assigned-instagram-accounts
  • GET /{ad account id}/instagram-accounts
  • GET /{ad account id}/connected-instagram-accounts-with-iabp
  • POST /{page-id}/page-backed-instagram-accounts
  • DELETE /{business-id}/instagram-accounts

Please migrate your API calls to the Instagram Platform endpoints.

December 4, 2024

Instagram Basic Display API

Applies to all versions.

The Instagram Basic Display API has been deprecated. All requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

October 3, 2024

Welcome Message Flows now available for Instagram API with Instagram Login. Learn more.

October 2, 2024

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

September 17, 2024

New scope values

Applies 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_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

These will replace the existing business_basic, business_content_publish, business_manage_comments and business_manage_messages values, respectively.

Please note that the old scope values will be deprecated on January 27, 2025. 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.

Correction: Deprecation date moved from December 17, 2024 to January 27, 2025.

July 23, 2024

Launch of the new Instagram API with Instagram Login

Components of this new Instagram API:

  • A Facebook Page will no longer be required
  • The host URL for API calls is graph.instagram.com
  • New permissions for this API:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • The Messenger API will no longer be used to send Instagram messages
  • New apps will add the new Instagram product when creating a Meta app
  • Existing apps can add the new Instagram product in the App Dashboard

Visit our migration guide to learn if this new Instagram API with Instagram Login is right for you.

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 Businessの公開メディア上で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を使用してコメント作者に非公開返信(ダイレクトメッセージ)を送信したりできるようになりました。この機能をサポートするため、以下の変更がなされています。

  • 新しいGET /ig-user/live_mediaエッジにより、リクエスト時点でアプリユーザーにより配信中のライブ動画IGメディアを返すことができます
  • IGコメントのmediaフィールドにより、コメントの付けられたメディアについてのID (id)と公開場所(media_product_type)の両方を含むオブジェクトが返されるようになりました
  • 新しいInstagram Webhooksフィールドであるlive_commentsにより、アプリユーザーのライブ動画の配信中に付けられたライブコメントが含まれる通知を送信することができます

アプリユーザーのライブ動画IGメディアにコメントを付けたユーザーに非公開返信を送信する方法について詳しくは、InstagramメッセージAPIの非公開返信についてのドキュメントをご覧ください。

October 20, 2021

IGコメント

すべてのバージョンに適用。

2つの新しいフィールドがIG コメントに追加されました。

  • from — コメント作成者のIGSID (id)とユーザー名(username)を含むオブジェクトを返します。
  • parent_id — コメントが別のIGコメントに対して作成されたもの(別のコメントへの返信)である場合、親IGコメントのIDを返します。

Instagram Webhooks

すべてのバージョンに適用。

Instagram Webhooksのcommentsフィールドで、valueフィールドオブジェクトに以下のプロパティが含まれるようになりました。

  • from.id — コメントを作成したInstagramユーザーのIGSID。
  • from.username — コメントを作成したInstagramユーザーのユーザー名。
  • media.id — コメントが作成されたIGメディアのID。
  • media.media_product_type — コメントが作成されたIGメディアのサーフェス(公開場所)。
  • parent_id — コメントが別のIGコメントに対して作成されたもの(別のコメントへの返信)である場合、親IGコメントのID。

October 5, 2021

2021年10月5日以降に作成されたInstagram TV動画には、以下の変更が適用されます。その日付より前に作成されたInstagram TV動画には、これらの変更が適用されません。

  • media_product_typeフィールドから返されるのは、IGTVではなくFEEDになります
  • video_titleフィールドは返されません
  • Instagram Webhooksのcommentsフィールドとmentionsフィールドがサポートされるようになりました

2022年1月3日に、上記の変更がAPIの全バージョンおよびInstagram TVの全動画に、その作成日付には関係なく適用されます。つまり、2022年1月3日以降、APIの旧バージョンを使用するアプリはInstagram TV動画についてのクエリを実行できるようになります(読み取りサポートはv10.0で導入され、v10.0以上に限定されていました)。

v14.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メディアについてのクエリを別のエンドポイント経由で間接的に実行する場合、アプリユーザーがそのメディアを所有しておらず、メディアの所有者がそのメディアのいいねカウントを非表示にしている場合、フィールドは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指標がアルバムに対応し、従来の0ではなく、アルバム内のすべての動画のvideo_viewsの合計が返されるようになりました。

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!