Mentioned Media

This node allows you to get information about a media object on which your business has been @mentioned in a caption by another user.

Creating

This operation is not supported.

Reading

To get information about a media object on which your business was @mentioned in a caption, send a GET request to the /user?fields=mentioned_media node on your Business Account and include the media_id field along with the media object's ID.

Permissions

A User access token with the following permissions:

  • instagram_basic
  • instagram_manage_comments

If the token is for 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

Fields

  • caption
  • comments
  • comments_count
  • like_count
  • media_type
  • media_url
  • owner — The ID of the user who owns the object.
  • timestamp
  • username

Pagination

If you are using field expansion to access an edge that supports cursor-based pagination, the response will include before and after cursors if the response contains multiple pages of data. Unlike standard cursor-based pagination, however, the response will not include previous or next fields, so you will have to use the before and after cursors to construct previous and next query strings manually in order to page through the returned data set.

Sample Request

GET graph.facebook.com
  /17841405309211844
    ?fields=mentioned_media.media_id(17873440459141021){caption,media_type}

Sample Response

{
  "mentioned_media": {
    "caption": "At @metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Updating

This operation is not supported.

Deleting

This operation is not supported.