Tags

Updated: Aug 12, 2026

Copy for LLM

Represents a collection of IG Media objects in which your app user’s Instagram professional account has been tagged by another Instagram user.

Creating

This operation is not supported.

Reading

GET /<IG_USER_ID>/tags

Returns a list of IG Media objects in which an IG User has been tagged by another Instagram user.

The media_url field is omitted for video media that contains copyrighted or licensed audio, including audio added from the Instagram audio library, or that has been flagged for a copyright violation. This applies to all video media, including media the app user owns. It is also omitted for reels whose owner has turned off reel downloads, on requests that read another user’s media: business discovery, tags, mentions, hashtag search, and collaborative media. That condition is evaluated against the reel’s owner, so it can apply to a reel the app user co-authored. All other fields are returned as normal. See IG Media for details.

Limitations

Private IG Media objects will not be returned.

Requirements

Type	Description
Access Tokens	User
Features	Not applicable.
Permissions	`instagram_basicinstagram_manage_commentspages_read_engagement` 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` or `ads_read`.
Tasks	The app user must be able to perform appropriate Tasks on the Page based on the Permissions requested by the app.

Request Syntax

GET https://graph.facebook.com/<IG_USER_ID>/tags
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Query String Parameters

Include the following query string parameters to augment the request.

Key	Value
`access_token` Required String	The app user’s Instagram User Access Token.
`fields` Comma-separated list	A comma-separated list of Fields and Edges you want included in the response. If omitted, default fields will be returned.
`media_type` Optional Comma-separated list	Return only media of the specified type(s). One or more of `IMAGE`, `VIDEO`, or `CAROUSEL_ALBUM` (for example, `media_type=IMAGE,VIDEO`). Any other value returns an error.
`posted_after` Optional ISO 8601 datetime	Return only media posted strictly after this time. Accepts an ISO 8601 datetime (for example, `2023-10-11T09:12:31`). A value with no offset is treated as UTC. The bound is strict.
`posted_before` Optional ISO 8601 datetime	Return only media posted strictly before this time. Uses the same format as `posted_after`. If you supply both, `posted_before` must be after `posted_after`.

Note: These filters are applied after each page of results is selected, so a page can contain fewer items than the requested page size, or none at all, even when more matching media exist further back. Treat a short or empty page as normal and keep paginating using the returned after cursor. This filtering capability is rolling out gradually, so it might not be enabled for your app yet.

Fields

Use the fields query string parameter to specify fields you want included on any returned IG Media objects.

Edges

Use the fields query string parameter to specify Edges you want included on any returned IG Media objects.

Response

A JSON-formatted object containing IG Media objects.

{
  "<FIELD>":"<VALUE>",
  ...
}

Pagination

This edge supports cursor-based pagination so 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/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

Sample Response

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

Updating

This operation is not supported.

Deleting

This operation is not supported.