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

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/v7.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

Query String Parameters

ParameterValue

{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

FieldDescription

caption
String

The caption text.

comments
Object

A list of IG Comments on the IG Media.

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/v7.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

Sample Response

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

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.