Instagram 플랫폼

Instagram(IG) 댓글

Instagram 미디어 개체에 달린 댓글을 나타냅니다.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

다음 필드를 소개합니다.

  • legacy_instagram_comment_id

다음 필드는 지원되지 않습니다.

  • comment_type
  • mentioned_instagram_users

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

만들기

지원되지 않는 작업입니다.

읽기

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

IG 댓글에서 필드와 에지를 가져옵니다.

제한 사항

  • Mentions API를 통해 발견된 댓글에 대해서는 댓글 소유자의 요청을 제외하고는 요청을 수행할 수 없습니다. 대신 언급된 댓글 노드를 사용하세요.
  • 나이 제한이 있는 미디어에 대한 댓글은 반환되지 않습니다.
  • 앱 사용자가 제한한 IG 사용자가 작성한 댓글은 반환되지 않습니다. 단, 해당 IG 사용자의 제한이 해제되고 댓글이 승인되는 경우는 예외입니다.
  • 라이브 방송 IG 미디어에 대한 댓글은 댓글이 달린 IG 미디어가 방송되는 동안에만 읽을 수 있습니다.

요청 구문

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

경로 매개변수

자리 표시자값

<API_VERSION>

API 버전.

<HOST_URL>

API 버전.

<IG_COMMENT_ID>

필수 항목. IG 댓글 ID.

쿼리 문자열 매개변수

키자리 표시자값

access_token

<ACCESS_TOKEN>

필수 항목. 앱 사용자의 사용자 액세스 토큰입니다.

fields

<LIST_OF_FIELDS>

결과 세트에서 각 IG 댓글에 대해 반환하고자 하는 IG 댓글 필드를 쉼표로 구분한 리스트.

필드

필드 이름설명

from

개체에는 다음 항목이 포함됩니다.

  • id — IG 댓글을 달았던 Instagram 사용자의 Instagram-범위 ID(IGSID).
  • username — IG 댓글을 달았던 Instagram 사용자의 사용자 이름.

hidden

댓글이 숨겨져 있는지(true) 숨겨져 있지 않은지(false) 표시.

id

IG 댓글 ID.

like_count

IG 댓글의 좋아요 수.

legacy_instagram_comment_id

마케팅 API 엔드포인트 v21.0 이하에 대해 생성된 Instagram 댓글의 ID.

media

개체에는 다음 항목이 포함됩니다.


  • id — IG 댓글이 달린 IG 미디어의 ID.
  • media_product_type — IG 댓글이 달린 IG 미디어가 게시된 화면(즉, IG 미디어가 표시되는 화면).

parent_id

해당 댓글이 다른 IG 댓글에서 작성된 경우(즉, 다른 댓글에 대한 답글인 경우) 상위 IG 댓글의 ID.

replies

IG 댓글에 달린 답글(IG 댓글)의 리스트.

text

IG 댓글 텍스트.

timestamp

IG 댓글이 작성된 시점을 나타내는 ISO 8601 형식의 타임스탬프.


예: 2017-05-19T23:27:28+0000.

user

IG 댓글을 작성한 IG 사용자의 ID. 앱 사용자가 IG 댓글을 작성한 경우에만 반환되고 그렇지 않을 경우에는 username이 대신 반환됩니다.

username

IG 댓글을 작성한 Instagram 사용자의 사용자 이름.

2024년 8월 27일부터 앱 사용자의 Instagram 프로페셔널 계정의 미디어에 댓글을 남긴 Instagram 사용자의 username 필드에 액세스하려면 instagram_manage_comments 권한(앱이 Facebook 로그인을 사용하는 경우)과 instagram_business_manage_comments 권한(앱이 Instagram 로그인을 사용하는 경우)이 필요합니다.

에지

에지설명

replies

IG 댓글에 달린 IG 댓글의 리스트를 가져옵니다. IG 댓글에 IG 댓글을 작성합니다.

응답

기본 및 요청된 필드와 에지를 포함하는 JSON 형식의 개체입니다.

{
  "<FIELD>":"<VALUE>",
  ...
}

cURL 예시

요청

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

응답

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

업데이트

댓글 숨기기/표시하기

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

쿼리 문자열 매개변수

  • hide(필수) — 댓글을 숨기려면 true로 설정하고, 댓글을 표시하려면 false로 설정합니다.

제한 사항

  • 미디어 개체 소유자가 자신의 미디어 개체에 남긴 댓글은 hide=true로 설정되었더라도 항상 표시됩니다.
  • 라이브 방송 IG 미디어에 대한 댓글은 지원되지 않습니다.

액세스 토큰

댓글을 남긴 미디어 개체를 소유한 사용자의 사용자 액세스 토큰입니다.

요청 예시

댓글 숨기기:

POST graph.instagram.com
  /17873440459141021?hide=true

응답 예시

{
  "success": true
}

삭제

댓글 삭제

DELETE <HOST_URL>/<IG_COMMENT_ID>

액세스 토큰

댓글을 작성한 사용자의 사용자 액세스 토큰입니다.

제한 사항

  • 댓글을 작성한 개체의 소유자만 댓글을 삭제할 수 있습니다. 댓글을 삭제하려는 사용자가 댓글의 작성자여도 삭제할 수 없습니다.
  • 라이브 방송 IG 미디어에 대한 댓글은 지원되지 않습니다.

요청 예시

DELETE graph.instagram.com
  /17873440459141021

응답 예시

{
  "success": true
}