Instagram Platform

IG Hashtag Recent Media

Updated: Jul 23, 2024
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.

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 read_pages_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.
  • 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.