List Instagram Media - Markifact

Lists the posts of an Instagram account on the Meta Ads connection (Reels, feed posts, stories) with permalink, shortcode and media id, and resolves an Instagram post URL or shortcode to the media id. Use it to find the instagram_media_id that meta_ads_create_ad_from_post needs to advertise an existing Instagram post.


App	Meta Ads
Operation ID	`meta_ads_list_instagram_media`
Type	Action
Connection	`meta_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`instagram_user_id`	string	Yes	-	Instagram account ID whose posts to list. Get it from meta_ads_list_instagram_accounts.
`permalink_or_shortcode`	string	No	-	Return only the post matching this Instagram permalink (for example `https://www.instagram.com/reel/DZMUH0RIIfE/`) or bare shortcode (DZMUH0RIIfE). Use it to resolve a post URL to the media id that meta_ads_create_ad_from_post needs as instagram_media_id.
`media_product_type`	enum (`REELS`, `FEED`, `STORY`, `AD`)	No	-	Return only posts of this kind: REELS, FEED, STORY or AD. Default: all.
`limit`	integer	No	`50`	Maximum number of posts to return (1-1000). Default: 50

Output

Type: List[Dict] Returns one row per post with id (the instagram_media_id for ad creation), permalink, shortcode, media_product_type, media_type, caption, timestamp and thumbnail_url. Fields: dynamic (depend on the inputs)