Mentioned Media

Returns data on an IG Media in which an IG User has been @mentioned in a caption by another Instagram user.

Creating

This operation is not supported.

Reading

GET /{ig-user-id}?fields=mentioned_media.media_id

Returns data on an IG Media in which an IG User has been @mentioned in a caption by another Instagram user.

Requirements

Type Description

Type	Description
Access Tokens	User
Permissions	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` If the app user was granted a role on the Page via the Business Manager, you will also need one of: `ads_management` `business_management`
Tasks	`MANAGE`, `CREATE_CONTENT`, or `MODERATE`

Access Tokens

User

Permissions

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

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

ads_management
business_management

Tasks

MANAGE, CREATE_CONTENT, or MODERATE

Request Syntax

GET https://graph.facebook.com/v9.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

Query String Parameters

Parameter	Value
`{access_token}` Required String	The app user's User Access Token.
`{fields}` Comma-separated list	A comma-separated list of IG Media Fields you want returned. If omitted, default Fields will be returned.
`{media-id}` Required String	The ID of the IG Media in which the IG User has been @mentioned in a caption. The ID is included in the Webhook notification payload.

Fields

Field	Description
`caption` String	The caption text. Captions that @mention an IG User will not include the `@` symbol unless the app user created the IG Media object upon which the caption was made.
`comments` Object	A list of IG Comments on the IG Media. If using Field Expansion to get the comment text, text that @mentions an IG User will not include the `@` symbol unless the app user created the IG Media object upon which the caption was made.
`comments_count` String	Number of IG Comments on the IG Media.
`id` Default String	ID of the IG Media.
`like_count` String	Number of times the IG Media has been liked.
`media_type` String	The IG Media's type: `CAROUSEL_ALBUM`, `IMAGE`, `STORY`, or `VIDEO`.
`media_url` String	URL of the published IG Media.
`owner` String	ID of the IG User who created the IG Media. Only returned if the app user created the IG Media object, otherwise the `username` field will be returned instead.
`timestamp` String	Creation date of IG Media formatted in ISO 8601.
`username` String	Username of the IG User who created the IG Media.

Sample Request

curl -X GET \
  'https://graph.instagram.com/v9.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

Sample Response

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

Note that in the sample above, the API has stripped out the leading @ symbol from the original caption (@metricsaurus headquarters!) because the app user did not create the caption.

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.

Updating

This operation is not supported.

Deleting

This operation is not supported.