IG Comment

Represents a comment on an IG Media object.

This node allows you to:

Creating

You cannot use this node to create comments. To create a comment on a media object, use the IG Media node instead.

Reading

Reading a Comment

GET /{ig-comment-id}?fields={fields}

Query String Parameters

Query string parameters are optional unless indicated as required.

  • {fields} — A comma-separated list of fields you want returned. See Returnable Fields.

Limitations

  • Operations cannot be performed on comments discovered through the Mentions API unless the request is made by the comment owner. Instead, use the Mentioned Comment node.
  • Comments on age-gated media are not returned.
  • Comments created by IG Users who have been restricted by the app user will not be returned unless the IG Users are unrestricted and the Comments are approved.

Permissions

A User access token from the Facebook User who created the object on which the comment was created, with the following permissions:

  • instagram_basic
  • manage_pages or pages_show_list

If the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

On May 5, 2020, we released six new Page permissions to replace the manage_pages and publish_pages permissions. The manage_pages permission has been replaced with pages_manage_ads, pages_manage_metadata, pages_read_engagement, and pages_read_user_content. The publish_pages permission has been replaced with pages_manage_posts and pages_manage_engagement.

Please visit our V7.0 Blog post, Graph API Changelog, and Pages API Overview for more information.

Returnable Fields

  • hidden
  • id
  • like_count
  • media
  • replies
  • text
  • timestamp
  • user (only returned if the user making the query also owns the comment, otherwise, the username field will be included)
  • username

Sample Request

GET graph.facebook.com/17873440459141021

Sample Response

{
  "timestamp": "2017-05-03T16:09:08+0000",
  "text": "Awesome :)",
  "id": "17873440459141021"
}

Updating

Hiding/Unhiding a Comment

POST /{ig-comment-id}?hide={hide}

Query String Parameters

  • {hide} (required) — Set to true to hide the comment, or false to show the comment.

Limitations

Comments made by media object owners on their own media objects will always be displayed, even if the comments have been set to hide=true.

Permissions

A User access token from a Facebook User who created the comment, with the following permissions:

  • instagram_basic
  • instagram_manage_comments
  • manage_pages or pages_show_list

If the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

On May 5, 2020, we released six new Page permissions to replace the manage_pages and publish_pages permissions. The manage_pages permission has been replaced with pages_manage_ads, pages_manage_metadata, pages_read_engagement, and pages_read_user_content. The publish_pages permission has been replaced with pages_manage_posts and pages_manage_engagement.

Please visit our V7.0 Blog post, Graph API Changelog, and Pages API Overview for more information.

Sample Request

Hiding a comment:

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

Sample Response

{
  "success": true
}

Deleting

Deleting a Comment

DELETE /{ig-comment-id}

Permissions

A User access token from a User who created the comment, with the following permissions:

  • instagram_basic
  • instagram_manage_comments

If the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

On May 5, 2020, we released six new Page permissions to replace the manage_pages and publish_pages permissions. The manage_pages permission has been replaced with pages_manage_ads, pages_manage_metadata, pages_read_engagement, and pages_read_user_content. The publish_pages permission has been replaced with pages_manage_posts and pages_manage_engagement.

Please visit our V7.0 Blog post, Graph API Changelog, and Pages API Overview for more information.

Limitations

A comment can only be deleted by the owner of the object upon which the comment was made, even if the user attempting to delete the comment is the comment's author.

Sample Request

DELETE graph.facebook.com
  /17873440459141021

Sample Response

{
  "success": true
}