Se actualizó este documento.
La traducción en español no está disponible todavía.

Actualización del documento en inglés: 18 abr. 2022
Actualización del documento en español: 2 jun. 2021

IG User Mentioned Comment

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

Creating

This operation is not supported.

Reading

GET /{ig-user-id}?fields=mentioned_comment.comment_id

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

Limitations

This endpoint will return an error if comments have been disabled on the IG Media on which the IG User has been @mentioned.

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/v19.0/{ig-user-id}
  ?fields=mentioned_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

Query String Parameters

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

Fields

Field	Description
`id` Default String	ID of the IG Comment.
`like_count` String	Number of times the IG Comment has been liked.
`media` String	ID of the IG Media on which the IG Comment was made. Use Field Expansion to get additional fields on the returned IG Media entity.
`text` Default String	Text of the IG Comment.
`timestamp` Default String	IG Comment creation date formatted in ISO 8601.

Response

Sample Request

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

Sample Response

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Field Expansion

You can expand the media field with a list of IG Media fields to get additional data on the IG Media entity on which the comment was made. For example:

media{id,media_url}

Llamadas a la versión 10.0 y anteriores hasta el 7 de septiembre de 2021: el campo like_count en un contenido multimedia de Instagram devuelve 0 si el propietario del contenido multimedia tiene ahí conteos de Me gusta ocultos.

Llamadas a la versión 11.0 y posteriores y todas las versiones desde el 7 de septiembre de 2021: si se consulta de forma indirecta un contenido multimedia de IG a través de otro punto de conexión o una expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia tiene ahí conteos de Me gusta ocultos. Solicitar de manera directa el contenido multimedia de IG (algo que solo el propietario del contenido multimedia de IG puede hacer) devolverá el conteo real de Me gusta, incluso si se ocultaron estos conteos.

Sample Field Expansion Request

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

Sample Field Expansion Response

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "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.