Instagram 플랫폼

Instagram 플랫폼 변경 사항

이 변경 사항은 Instagram API에 적용된 변경 사항을 나타냅니다.

관련 변경 사항

2024년 10월 3일

Instagram 로그인을 통한 Instagram API에 환영 메시지 플로를 사용할 수 있게 되었습니다. 더 알아보기.

2024년 10월 2일

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

2024년 9월 17일

새로운 scope 값

모든 버전에 적용됩니다.

scope 값과 권한 이름 사이의 일관성을 유지하기 위해 Instagram 로그인을 통한 Instagram API에 새로운 scope 값을 도입합니다. 새로운 scope 값은 다음과 같습니다.

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

위의 값이 기존의 business_basic, business_content_publish, business_manage_comments, business_manage_messages 값을 각각 대체할 것입니다.

이전의 scope 값은 2025년 1월 27일에 사용 중단됩니다. 앱 기능이 중단되지 않도록 이 날짜 전에 코드를 업데이트하셔야 합니다. 그렇지 않으면 앱이 Instagram 엔드포인트를 호출할 수 없게 됩니다.

정정 사항: 사용 중단 날짜가 2024년 12월 17일에서 2025년 1월 27일로 변경되었습니다.

2024년 7월 23일

Instagram 로그인을 통한 새로운 Instagram API가 출시되었습니다.

새로운 Instagram API의 구성 요소:

  • 더 이상 Facebook 페이지가 필요하지 않습니다.
  • API 호출의 호스트 URL은 graph.instagram.com입니다.
  • 이 API에 대한 새로운 권한:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • 더 이상 Messenger API가 Instagram 메시지를 보내는 데 사용되지 않습니다.
  • Meta 앱을 만들 때 새로운 앱에서 새로운 Instagram 제품을 추가합니다.
  • 기존 앱은 앱 대시보드에서 새로운 Instagram 제품을 추가할 수 있습니다.

Instagram 로그인을 통한 새로운 Instagram API가 적합한지 알아보려면 마이그레이션 가이드를 참조하세요.

2024년 6월 11일

Instagram 댓글 Webhooks

모든 버전에 적용됩니다.

사용자가 Instagram 홍보 게시물 또는 Instagram 광고 게시물에 댓글을 남기면 ad_id 및 ad_title 외에도 original_media_id가 comments 필드의 value 개체의 media 개체에 반환됩니다. 자세한 내용은 Instagram용 Webhooks 설정을 참조하세요.

2024년 5월 21일

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:

2023년 9월 12일

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.

2022년 11월 9일

Instagram Webhooks

모든 버전에 적용됩니다.

사용자가 Instagram 홍보 게시물 또는 Instagram 광고 게시물에 댓글을 남기면 comments 필드의 value 개체의 media 개체에 ad_id 및 ad_title이 반환됩니다.

10월 31일

릴스 – 제품 태그

모든 버전에 적용됩니다.

릴스용 Instagram 제품 태그 API를 사용할 수 있습니다. 릴스를 게시할 때 최대 30개 제품까지 태그할 수 있습니다.

2022년 6월 28일

릴스

모든 버전에 적용됩니다.

이제 릴스가 지원됩니다. 동영상을 릴스로 게시하려면 단일 미디어 게시물 컨테이너를 만들 때 media_type 매개변수를 REELS로 설정하세요. 릴스에 사용할 수 있는 매개변수와 릴스 동영상 요구 사항에 대해 알아보려면 POST /ig-user/media endpoint 참고 자료를 참조하세요.

2022년 6월 27일

기존 Instagram API 문서

모든 버전에 적용됩니다.

기존 Instagram API 개발자 문서가 삭제되었고, 이제 Instagram 플랫폼 개발자 문서로 리디렉션됩니다.

2022년 6월 20일

제품 태그

모든 버전에 적용됩니다.

이제 Instagram 비즈니스의 게시된 미디어에 대해 Instagram Shopping 제품 태그를 만들고 관리할 수 있습니다. 자세한 방법은 제품 태그 가이드를 참조하세요.

2022년 5월 27일

제품 에디션

모든 버전에 적용됩니다.

제품 태그 베타에 참여하는 파트너의 경우 제품 카탈로그 검색 시 쿼리의 검색 기준과 일치하는 모든 제품 에디션이 반환됩니다.

2022년 3월 15일

슬라이드 게시물

모든 버전에 적용됩니다.

이제 Instagram API를 사용하여 여러 이미지와 동영상이 포함된 게시물(슬라이드 게시물)을 게시할 수 있습니다. 전체 게시 절차에 대한 자세한 내용은 콘텐츠 게시 가이드를 참조하세요.

앱이 콘텐츠 게시에 필요한 권한에 대해 이미 승인을 받은 경우 이 기능을 활용할 때 다시 앱 검수를 거칠 필요가 없습니다.

2021년 11월 9일

라이브 방송

모든 버전에 적용됩니다.

이제 Instagram API를 통해 앱 사용자가 방송하는 라이브 방송 IG 미디어 및 해당 라이브 방송에 대한 댓글을 가져오고, Instagram 메시지 API를 통해 비공개 답장(다이렉트 메시지)을 댓글 작성자에게 보낼 수 있습니다. 이 기능을 지원하기 위해 다음과 같은 변경 사항이 적용되었습니다.

  • 새로운 GET /ig-user/live_media 에지는 요청 시점에 앱 사용자가 방송 중인 라이브 방송 IG 미디어를 반환할 수 있습니다.
  • 이제 IG 댓글의 media 필드에서 댓글이 달린 미디어의 ID(id)와 게시된 위치(media_product_type)가 포함된 개체를 반환합니다.
  • 새 live_comments Instagram Webhook 필드는 방송 중에 앱 사용자의 라이브 방송에 달린 라이브 댓글을 포함한 알림을 보낼 수 있습니다.

앱 사용자의 라이브 방송 IG 미디어에 댓글을 남긴 사용자에게 비공개 답장을 보내는 방법은 Instagram 메시지 API 비공개 답장 문서를 참조하세요.

2021년 10월 20일

IG 댓글

모든 버전에 적용됩니다.

새로운 필드 2개가 IG 댓글에 추가되었습니다.

  • from — 댓글 작성자의 IGSID(id)와 사용자 이름(username)을 포함한 개체를 반환합니다.
  • parent_id — 해당 댓글이 다른 IG 댓글에서 작성된 경우(즉, 다른 댓글에 대한 답글) 상위 IG 댓글의 ID를 반환합니다.

Instagram Webhooks

모든 버전에 적용됩니다.

이제 comments Instagram Webhooks 필드에 value 필드 개체의 다음과 같은 속성이 포함됩니다.

  • from.id — 댓글을 작성한 Instagram 사용자의 IGSID
  • from.username — 댓글을 작성한 Instagram 사용자의 사용자 이름
  • media.id — 댓글을 남긴 IG 미디어의 ID
  • media.media_product_type — 댓글을 남긴 IG 미디어의 화면(게시된 위치)
  • parent_id — 해당 댓글이 다른 IG 댓글에서 작성된 경우(즉, 다른 댓글에 대한 답글) 상위 IG 댓글의 ID

2021년 10월 5일

다음 변경 사항은 2021년 10월 5일 및 그 이후에 생성된 Instagram TV 동영상에 적용됩니다. 이 날짜 이전에 생성된 Instagram TV 동영상에는 해당 변경 사항이 적용되지 않습니다.

  • media_product_type필드가 IGTV 대신 FEED를 반환합니다.
  • video_title필드가 반환되지 않습니다.
  • 이제 Instagram Webhookscomments 및 mentions 필드가 지원됩니다.

2022년 1월 3일에 위의 변경 사항이 동영상 생성 날짜와 무관하게 모든 API 버전과 모든 Instagram TV 동영상에 적용됩니다. 즉, 2022년 1월 3일부터 이전 API 버전을 사용하는 앱은 Instagram TV 동영상을 쿼리할 수 있게 됩니다(읽기 지원은 v10.0에 도입되었으므로 v10.0 이상에서만 지원됨).

v14.0부터 video_title 필드가 더 이상 지원되지 않으며 이 필드를 요청하면 API에서 오류가 발생합니다.

2021년 6월 8일

좋아요 개수

v11.0 이상에 적용됩니다. 2021년 9월 7일에 모든 버전에 적용됩니다.

다른 엔드포인트 또는 필드 확장을 통해 IG 미디어를 간접적으로 쿼리할 경우 미디어 소유자가 미디어의 좋아요 개수를 숨겼다면 like_count 필드는 API 응답에서 생략됩니다. IG 미디어를 직접 쿼리하면(IG 미디어 소유자만 가능) 좋아요 개수가 숨겨져 있더라도 실제 좋아요 개수가 반환됩니다.


시간 기반 페이지 매김

v11.0 이상에 적용됩니다.

시간 기반 페이지 매김을 지원하기 위해 since 및 until 매개변수를 GET /{ig-user-id}/media 엔드포인트에 추가했습니다.

2021년 5월 26일

다른 엔드포인트를 통해 IG 미디어를 간접적으로 쿼리할 때 앱 사용자가 미디어를 소유하지 않고 미디어 소유자가 좋아요 개수를 숨겼을 경우 like_count는 0을 반환합니다. IG 미디어를 직접 쿼리하면(IG 미디어 소유자만 가능) 소유자가 해당 미디어의 좋아요 개수를 숨겼더라도 실제 좋아요 개수를 반환합니다.

2021년 5월 4일

IG 사용자에 대한 online_followers 지표 계산 방법을 다소 변경하였습니다.

2021년 4월 14일

일본 사용자의 스토리 IG 미디어 상호작용은 더 이상 일부 replies 지표 계산에 포함되지 않습니다.

  • 일본 사용자가 생성한 스토리의 경우 replies 지표에서 0 값이 반환됩니다.
  • 일본 이외 지역의 사용자가 생성한 스토리의 경우 replies 지표가 답글 수를 반환하지만 일본 사용자가 작성한 답글은 계산에 포함되지 않습니다.

2021년 4월 12일

스토리 IG 미디어에서 도달 지표의 사소한 버그가 수정되었습니다.

2021년 4월 9일

2021년 3월 16일

이제 IGTV 미디어가 v10.0 이상에서 지원됩니다. 콘텐츠 게시와 Webhooks에 사용하는 것을 제외한 모든 엔드포인트에 적용됩니다. 이 변경 사항을 지원하기 위해 새로운 media_product_type과 video_title 필드를 IG 미디어 노드에 추가했습니다. API를 통해 IGTV 미디어에 액세스하려면 게시 시점(미리 보기 게시 또는 미리 보기를 피드에 공유 활성화)에 해당 미디어가 Instagram에 공유된 상태여야 합니다.

2021년 1월 26일

콘텐츠 게시 베타가 종료되었으며 이제 모든 개발자가 Instagram 프로페셔널 계정에 미디어를 게시할 수 있습니다. 사용 방법에 대한 자세한 내용은 콘텐츠 게시 가이드를 참조하세요.

2020년 12월 2일

유럽 연합의 온라인 개인정보 보호 지침을 준수하기 위해 2020년 12월 1일 이후 유럽 경제 지역(EEA)에서 사용자가 수행한 메시지 관련 스토리 IG 미디어 인터랙션은 일부 지표 계산에 포함되지 않습니다.

  • EEA에서 사용자가 생성한 스토리의 경우 replies 지표가 0 값을 반환합니다.
  • EEA 이외 지역에서 사용자가 생성한 스토리의 경우 replies 지표가 답글 수를 반환하지만 EEA에서 자신의 사용자가 작성한 답글은 계산에 포함되지 않습니다.

이 변경 사항은 모든 버전에 적용됩니다.

2020년 11월 10일

  • IG 사용자 인사이트 — follower_count 값이 Instagram 앱에 표시된 해당 값과 더욱 가깝게 조정됩니다. 또한 follower_count는 2년간의 데이터 대신 최대 30일간의 데이터를 반환합니다. 이 변경 사항은 v9.0 이상에 적용되고 2021년 5월 9일부터 모든 버전에 적용됩니다.

2020년 5월 5일

2019년 12월 3일

  • 인사이트 — API 동작과 Instagram 앱 동작을 일치시키기 위해 이제 IG 사용자에 대한 인사이트는 팔로워가 100명 이상인 IG 사용자에 대해서만 제공됩니다.

2019년 8월 13일

  • 비즈니스 검색 — 비즈니스 검색 API는 다른 Instagram 크리에이터 계정에 대한 데이터를 가져오는 데 사용할 수 있습니다.

2019년 5월 22일

2019년 5월 9일

  • Webhook — 이제 story_insights 필드는 instagram_manage_comments 권한이 아니라 instagram_manage_insights 권한이 필요합니다.

2018년 10월 31일

  • 해시태그 검색 API — 이제 새로운 해시태그 검색 API를 사용하여 특정 해시태그로 태그된 미디어를 검색할 수 있습니다. #spooky!

2018년 10월 23일

  • /{ig-media-id}/comments 에지 — API 버전 3.1 이하를 사용하여 GET 요청을 보내면 결과가 시간 순서대로 반환됩니다. 버전 3.2 이상을 사용하여 요청을 보내면 결과가 역순으로 반환됩니다.

2018년 6월 7일

  • /{ig-media-id} 노드 — 이제 필드 확장을 사용하여 미디어 개체에 대한 permalink 필드를 가져올 수 있습니다.

2018년 5월 1일

  • 비즈니스 인증 — Instagram 그래프 API를 사용하려면 모든 앱이 비즈니스 인증을 받아야 합니다. 이는 앱 검수 절차의 일환으로, 이제 모든 Instagram 그래프 API 엔드포인트에 필수입니다. 2018년 5월 1일 이전에 검수받은 앱은 다시 검수받아야 하고 2018년 8월 1일까지 검수 절차를 거쳐야 API 액세스 권한이 상실되지 않습니다.

2018년 4월 24일

  • /{ig-comment-id} 노드:
    • 새 username 필드를 추가했습니다.
    • GET 요청의 경우 user 필드는 응답에 포함되지 않습니다(요청을 보낸 사용자가 댓글을 소유하는 경우 제외). 대신 Facebook에서는 댓글을 단 모든 사용자에 대해 username을 반환합니다. 이는 다른 API(예: Mentions API)를 통해 작성한 댓글에 대한 쿼리에도 적용됩니다.
  • /{ig-media-id} 노드:
    • 새 username 필드를 추가했습니다.
    • GET 요청의 경우 owner 필드는 응답에 포함되지 않습니다(요청을 보낸 사용자가 미디어 개체를 소유하는 경우 제외). 대신 Facebook에서는 댓글을 단 모든 사용자에 대해 username을 반환합니다. 이는 다른 API(예: Mentions API)를 통해 작성한 미디어 개체 쿼리에도 적용됩니다.

2018년 4월 23일

  • 인사이트 API — 이제 인사이트에 API, Facebook 광고 인터페이스, Instagram 홍보 기능을 통해 생성된 광고 활동이 포함됩니다. 이는 다음 지표에 영향을 미칩니다.

    • impressions
    • reach

2018년 3월 13일

  • 콘텐츠 게시 API — 이제 베타 파트너는 사진을 게시할 때 /{ig-user-id}/media 에지를 사용하여 위치와 전체 공개 Instagram 사용자를 태그할 수 있습니다.

2018년 3월 8일

  • 전체 공개 필드 — /{ig-media-id} 노드의 timestamp 필드가 이제 전체 공개 필드가 되었고 필드 확장을 통해 반환할 수 있습니다.

2018년 2월 22일

  • 전체 공개 필드 — /{ig-user-id}, /{ig-comment-id} 및 /{ig-media-id} 노드는 필드 확장을 사용하여 에지를 통해 액세스하면 모든 전체 공개 필드를 반환합니다. 어느 필드가 전체 공개되었는지 확인하려면 각 노드의 참고 자료를 참조하세요.

2018년 2월 8일

  • 콘텐츠 게시 API — 이제 베타 파트너는 /{ig-user-id}/media 에지를 통해 사진을 게시할 때 해시태그를 포함할 수 있습니다. #crazywildebeest FTW!