api.instagram.com
Instagram is a photo and video sharing social network. The Graph API allows agents to read user profiles, fetch media posts, publish photos and videos, manage comments, retrieve engagement insights, discover hashtags and mentions for business and creator accounts.
Enable this service
This service is in the catalog but not part of v1 launch billing. To use it, run the command below and provide your own API key in the local config page — the gateway will call it under your account.
oauth2
free
1.0
https://graph.facebook.com/v21.0
Aug 7, 2026
Health
This is a community-maintained manifest. Health monitoring is not available because this service doesn't host its own /.well-known/agent endpoint yet. Learn more about trust levels →
Top Capabilities
Most commonly used operations — ready to call without drill-down.
hashtag_recent_media_list
GETRetrieve recent media posts tagged with a specific hashtag.
GET https://graph.facebook.com/v21.0/{hashtag_id}/recent_media
hashtag_id (string, required) — The hashtag ID obtained from hashtag_search.
user_id (string, required) — The Instagram user ID performing the request.
fields (string) — Comma-separated fields to return.
hashtag_top_media_list
GETRetrieve top-performing media posts tagged with a specific hashtag.
GET https://graph.facebook.com/v21.0/{hashtag_id}/top_media
hashtag_id (string, required) — The hashtag ID obtained from hashtag_search.
user_id (string, required) — The Instagram user ID performing the request.
fields (string) — Comma-separated fields to return.
media_comments_list
GETRetrieve comments on a specific media post, including commenter username and comment text.
GET https://graph.facebook.com/v21.0/{media_id}/comments
media_id (string, required) — The ID of the media object.
fields (string) — Comma-separated list of fields for each comment.
limit (integer) — Number of comments per page.
All Capabilities (20)
publishing (5)
Publish a carousel post (multiple images/videos) to the authenticated user's Instagram feed.
Create a media container for content publishing. This is the first step in the two-step publishing process.
Publish a previously created media container to the user's Instagram feed.
Publish a photo to the authenticated user's Instagram feed by providing an image URL and optional caption.
Publish a reel (short video) to the authenticated user's Instagram feed.
comments (4)
Delete a comment on one of the authenticated user's media posts.
Hide or unhide a comment on one of the authenticated user's media posts.
Post a reply to a specific comment on one of the authenticated user's media posts.
Retrieve comments on a specific media post, including commenter username and comment text.
discovery (4)
Retrieve recent media posts tagged with a specific hashtag.
Search for a hashtag by name and retrieve its ID for use in fetching recent or top media.
Retrieve top-performing media posts tagged with a specific hashtag.
Retrieve media posts that mention or tag the authenticated user.
media (4)
Retrieve the individual items within a carousel album media post.
Retrieve detailed information about a specific media object including caption, media type, permalink, and timestamp.
Retrieve a list of currently active stories published by the authenticated user.
Fetch a paginated list of media posts (photos, videos, carousels) published by the authenticated user.
insights (2)
Retrieve engagement metrics (impressions, reach, likes, comments, saves, shares) for a specific media post on a business or creator account.
Retrieve account-level insights (impressions, reach, follower count, profile views) for a business or creator account over a time period.
users (1)
Retrieve the authenticated Instagram user's profile information including username, bio, follower count, and media count.
Agent Preview
This is what an AI agent sees when it discovers this service via the Gateway:
Service: Instagram
Description: Instagram is a photo and video sharing social network. The Graph API allows agents to read user profiles, fetch media posts, publish photos and videos, manage comments, retrieve engagement insights, discover hashtags and mentions for business and creator accounts.
Auth: oauth2
Capabilities (20 total):
publishing (5):
- carousel_publish: Publish a carousel post (multiple images/videos) to the authenticated user's Instagram feed.
- media_container_create: Create a media container for content publishing. This is the first step in the two-step publishing process.
- media_publish: Publish a previously created media container to the user's Instagram feed.
- photo_publish: Publish a photo to the authenticated user's Instagram feed by providing an image URL and optional caption.
- reel_publish: Publish a reel (short video) to the authenticated user's Instagram feed.
comments (4):
- comment_delete: Delete a comment on one of the authenticated user's media posts.
- comment_hide: Hide or unhide a comment on one of the authenticated user's media posts.
- comment_reply: Post a reply to a specific comment on one of the authenticated user's media posts.
- media_comments_list: Retrieve comments on a specific media post, including commenter username and comment text.
discovery (4):
- hashtag_recent_media_list: Retrieve recent media posts tagged with a specific hashtag.
- hashtag_search: Search for a hashtag by name and retrieve its ID for use in fetching recent or top media.
- hashtag_top_media_list: Retrieve top-performing media posts tagged with a specific hashtag.
- mentions_get: Retrieve media posts that mention or tag the authenticated user.
media (4):
- media_children_get: Retrieve the individual items within a carousel album media post.
- media_get: Retrieve detailed information about a specific media object including caption, media type, permalink, and timestamp.
- stories_list: Retrieve a list of currently active stories published by the authenticated user.
- user_media_list: Fetch a paginated list of media posts (photos, videos, carousels) published by the authenticated user.
insights (2):
- media_insights_get: Retrieve engagement metrics (impressions, reach, likes, comments, saves, shares) for a specific media post on a business or creator account.
- user_insights_get: Retrieve account-level insights (impressions, reach, follower count, profile views) for a business or creator account over a time period.
users (1):
- user_profile_get: Retrieve the authenticated Instagram user's profile information including username, bio, follower count, and media count.
Top capabilities (ready to call):
- hashtag_recent_media_list: GET /{hashtag_id}/recent_media
- hashtag_top_media_list: GET /{hashtag_id}/top_media
- media_comments_list: GET /{media_id}/comments