Official scripts

Explore our curated collection of scripts

Get Instagram home feed

Fetch the posts from your Instagram home (For You) feed.

Unmute a followed account

Unmute a previously muted Instagram account's posts and/or stories (requires following them).

Post Instagram comment

Post a comment on an Instagram post or reel by its shortcode. Returns comment_id, shortcode, comment, username, and created_at.

Share Instagram post via DM

Share an Instagram post or reel to a user via DM. Works for both posts and reels; fails loudly if the recipient handle isn't found in search. Returns shortcode, username, and thread_key.

List Instagram posts tagged at a location

Search Instagram for a place by name and list posts tagged there (the location page's "Top" grid). Returns the matched location's name, id and city, plus each post's code, owner username, caption and thumbnail image URL.

Save Instagram post

Save (bookmark) an Instagram post or reel by shortcode. Clicks the action-bar bookmark and confirms the Save→Remove flip. Fails loudly if already saved (no Save button) or unavailable. Returns shortcode and saved.

Instagram whoami (signed-in account)

Report which Instagram account this browser is signed in as: the user id, @username and name. Being signed out is reported as a normal answer (loggedIn false), not an error, so it can be used to check a session before running other Instagram scripts.

Get own Instagram profile

Read the logged-in Instagram account's own profile: handle, display name, bio, follower / following / post counts, profile picture and whether the account is private, verified or a business account.

Like Instagram post

Like an Instagram post or reel by shortcode. Clicks the action-bar heart and confirms the Like→Unlike flip (server-driven). Fails loudly if the post is already liked (no Like button) or unavailable. Returns shortcode and liked.

Mute a followed account

Mute an Instagram account's posts and/or stories from your feed (requires following them). Instagram does not notify the muted account.

Remove a follower

Remove a follower from the signed-in Instagram account. Irreversible from Instagram's own UI — the removed account would have to refollow to reconnect.

Unblock Instagram user

Unblock an Instagram user from their profile. Fails loudly if the profile doesn't render an Unblock button (i.e. they weren't blocked). Returns username, user_id, and blocking.

Unsave Instagram post

Remove an Instagram post or reel from your saved items by shortcode. Clicks the filled action-bar bookmark and confirms the Remove→Save flip. Fails loudly if it wasn't saved (no Remove button) or unavailable. Returns shortcode and saved.

Delete Instagram post

Delete one of your own Instagram posts or reels by shortcode. Opens the post, drives More options then Delete and the confirmation, and then reloads the post's link to prove it is really gone before reporting success. Returns the shortcode, the media id when Instagram exposes it, and whether the post was verified as removed. Fails clearly when the shortcode is not available to you (already deleted, private, or another account's) and when the post is still live after the confirmation.

Get Instagram DM participants

List the participants of an Instagram DM thread by thread_id (from get_inbox) — mainly useful for group DMs. Returns each participant's username, full name, profile picture and whether they are the viewer or a group admin.

Get Instagram following

List the accounts an Instagram user follows by their username. count=0 fetches every page. Returns count, has_more, and following (pk, username, full_name, is_private, is_verified, profile_pic_url). You'll get the complete list only for your own account or accounts you follow; for anyone else Instagram serves a limited preview.

Get Instagram user posts

Fetch the most recent posts from an Instagram user's profile, newest first. Returns code, url, taken_at, media_type, caption, like_count, comment_count, images, video_url, tagged_users, caption_mentions, coauthors, sponsor_tags, and is_paid_partnership. view_count is always null here; use get_user_reels for video play counts.

Block Instagram user

Block an Instagram user from their profile. Fails loudly if the profile doesn't render a Block option (e.g. already blocked). Returns username, user_id, and blocking.

Create Instagram post

Publish an Instagram feed post, a single image or a carousel of up to 10, from an attached file, image URLs, or inline base64 bytes. Drives the web composer (New post, crop, edit, caption, Share) and returns code, pk, url and the caption Instagram recorded. dry_run stops just before Share. Supersedes create_post_from_file.

Search Instagram users

Search Instagram accounts by keyword (name or handle). Returns ranked users with pk, username, full_name, is_private, is_verified, is_business, and profile_pic_url. Results are Instagram's own ranking; count is a hint the server may not honor exactly.

Get Instagram tagged posts

Fetch posts an Instagram user is tagged in, by their numeric user_id (from get_profile). Returns total_count, next_max_id (pass back as max_id to paginate), and posts (code, url, owner, like_count, comment_count, caption, thumbnail, media_type, taken_at). Only tagged posts the account allows to be shown are returned.

Get Instagram user stories

Fetch a user's currently-active story items by their numeric user_id (from get_profile). Returns username and items (id, taken_at, expiring_at, media_type 1=photo/2=video, image_url, video_url). Empty items = no active story (they expire after 24h) or the account's stories aren't visible to you.

Get Instagram user reels

Fetch an Instagram user's reels by their username; count=0 returns all. Returns pk, code, url, taken_at, caption, thumbnail, video_url, like_count, play_count, comment_count, and video_duration. Results follow the profile feed order, not strictly newest-first.

Follow Instagram user

Follow an Instagram user from their profile. outgoing_request=true means a pending request to a private account; fails if there's no Follow button (already followed/requested). Returns following, outgoing_request, followed_by, user_id.

Unlike Instagram post

Remove your like from an Instagram post or reel by shortcode. Clicks the filled action-bar heart and confirms the Unlike→Like flip (server-driven). Fails loudly if the post wasn't liked (no Unlike button) or unavailable. Returns shortcode and liked.