Checks the configured access token: which account it belongs to, where it comes from (env or refreshed cache), and its expiry when known. Also reports whether write actions are enabled.

Refreshes the long-lived access token for another 60 days (the token must be at least 24 hours old and not expired). The new token is saved to IG_TOKEN_CACHE_PATH; without it the new token only lives until the server restarts.

Profile of the connected professional account: username, name, bio, followers, follows and media counts.

Posts and reels of the connected account, newest first, with likes and comment counts. Pass next_cursor back as after for the next page.

One post, reel or story by media id, including carousel children.

Currently live stories of the connected account (stories disappear from the API after 24 hours).

Media from other accounts in which the connected account has been tagged.

Account-level metrics (views, reach, engagement, followers, demographics). Instagram keeps about 90 days of data; some metrics need 100+ followers. Metrics without data come back empty, not as 0. Demographic metrics (follower_demographics, engaged_audience_demographics) need period=lifetime, metric_type=total_value, a timeframe and a breakdown (age, city, country, gender).

Metrics for one post, reel or story. Without metrics, a default set for the media type is used (FEED / REELS / STORY). Only media of the connected account is supported.

Top-level comments on one of the account's posts or reels, with author, likes and hidden flag.

Replies to a comment on the account's media.

Posts a public reply to a comment. Requires IG_ENABLE_WRITES=true.

Adds a top-level comment to one of the account's posts or reels. Requires IG_ENABLE_WRITES=true.

Hides a comment from the public (or shows it again with hide=false). Requires IG_ENABLE_WRITES=true.

Permanently deletes a comment on the account's media. Cannot be undone. Requires IG_ENABLE_WRITES=true.

Turns comments on or off for one of the account's posts. Requires IG_ENABLE_WRITES=true.

Publishes a single-image feed post from a public JPEG URL. Requires IG_ENABLE_WRITES=true.

Publishes a reel from a public video URL. Video processing can take minutes: if it is not ready within wait_seconds, a pending container_id is returned for ig_publish_container. Requires IG_ENABLE_WRITES=true.

Publishes a story from a public image (JPEG) or video URL. Captions are not supported on stories. Requires IG_ENABLE_WRITES=true.

Publishes a carousel of 2–10 images and/or videos (counts as one post against the daily limit). If some videos are still processing, returns pending child container_ids: call again with those as items. Requires IG_ENABLE_WRITES=true.

Processing status of a media container: IN_PROGRESS, FINISHED, PUBLISHED, ERROR or EXPIRED.

Finishes publishing a container returned as pending by an ig_publish_* tool. Requires IG_ENABLE_WRITES=true.

How many posts the account has published via the API in the last 24 hours (limit: 100; a carousel counts as one).

Direct-message conversations of the account, most recently updated first. With user_id (an Instagram-scoped id) returns only the conversation with that person. Request-folder threads inactive for 30 days are not returned.

Messages of one conversation with sender, recipient and text. Instagram only returns the 20 most recent messages.

Sends a DM with text or one image. Instagram only allows it within 24 hours of the person's last message. recipient_comment_id sends a private reply to a commenter instead (one per comment). Requires IG_ENABLE_WRITES=true.