IG Hashtag Recent Media

Updated: Aug 17, 2026

Copy for LLM

Represents a collection of the most recently published photo and video IG Media objects that have been tagged with a hashtag.

Available for the Instagram API with Facebook Login.

Creating

This operation is not supported.

Reading

Returns a list of the most recently published photo and video IG Media objects published with a specific hashtag.

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.

Requirements

Type	Description
Features	`Instagram Public Content Access`
Permissions	`instagram_basic` 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`, `business_management`, or `pages_read_engagement`.
Tokens	A User access token of a Facebook User who has been approved for tasks on the connected Facebook Page.

Limitations

Only returns public photos and videos.
Only returns media objects published within 24 hours of query execution.
Will not return promoted/boosted/ads media.
Responses are paginated with a maximum limit of 50 results per page.
Responses will not always be in chronological order.
You can query a maximum of 30 unique hashtags within a 7 day period. Requesting this edge counts as querying the hashtag, even when you already have its ID, so it can count a hashtag against that limit.
You cannot request the username field on returned media objects.
This endpoint only returns an after cursor for paginated results; a before cursor will not be included. In addition, the after cursor value will always be the same for each page, but it can still be used to get the next page of results in the result set.

Syntax

GET /<IG_HASHTAG_ID>/recent_media?user_id=<USER_ID>&fields=<LIST_OF_FIELDS>

Parameters

Parameter Description

fields

A comma-separated list of fields on a media object

Value	Description
`caption`	The caption for the media object
`children`	Media objects in a carousel Album IG Media, if applicable
`comments_count`	The number of comments on the media object
`id`	The ID for the media object
`like_count`	The number of likes for the media object. Will be omitted if the media owner has hidden like counts in it
`media_type`	The type of media: `CAROUSEL_ALBUM`, `IMAGE`, or `VIDEO`.
`media_url`	The URL for the media object. Not returned for Album IG Media
`permalink`	The permalink for the media object
`timestamp`	Unix timestamp for when the media object was published

user_id

The ID for person querying the data

Example Request

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

Response

An array of IG Media objects. Excess results will be paginated.

Sample Response

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    }
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

Updating

This operation is not supported.

Deleting

This operation is not supported.