@robinpath/instagram

Instagram module for RobinPath.

Why use this module?

The instagram module lets you:

• Get authenticated user's Instagram profile (id, username, biography, followers, media count, etc.)
• Get details of a specific media item by ID
• List the authenticated user's media posts with pagination
• Create a media container for an image post (returns container ID for publishing)
• Create a media container for a video or Reel post

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/instagram

Quick Start

1. Set up credentials

instagram.setToken "EAAG..."

2. Store access token and IG Business Account ID for full API access

instagram.setBusinessAccount "EAAG..." "17841400123456"

Available Functions

Function	Description
instagram.setToken	Store a long-lived Instagram access token for API calls
instagram.setBusinessAccount	Store access token and IG Business Account ID for full API access
instagram.getProfile	Get authenticated user's Instagram profile (id, username, biography, followers, media count, etc.)
instagram.getMedia	Get details of a specific media item by ID
instagram.listMedia	List the authenticated user's media posts with pagination
instagram.createMediaContainer	Create a media container for an image post (returns container ID for publishing)
instagram.createVideoContainer	Create a media container for a video or Reel post
instagram.createCarouselContainer	Create a carousel container from multiple child container IDs
instagram.publishMedia	Publish a previously created media container (image, video, or carousel)
instagram.getMediaInsights	Get insights/analytics for a specific media item
instagram.getAccountInsights	Get account-level insights (impressions, reach, follower_count, etc.)
instagram.getComments	List comments on a media post
instagram.replyToComment	Reply to a specific comment on a media post
instagram.deleteComment	Delete or hide a comment by ID
instagram.getStories	Get the authenticated user's currently active stories
instagram.getHashtag	Search for a hashtag ID by name
instagram.getHashtagMedia	Get top or recent media for a hashtag
instagram.getMentions	Get media posts where the authenticated user is tagged/mentioned
instagram.sendMessage	Send a direct message to a user via Instagram Messaging API
instagram.getConversations	List DM conversations for the authenticated account
instagram.getMessages	Get messages within a specific DM conversation

Examples

Store access token and IG Business Account ID for full API access

instagram.setBusinessAccount "EAAG..." "17841400123456"

Get authenticated user's Instagram profile (id, username, biography, followers, media count, etc.)

instagram.getProfile

Get details of a specific media item by ID

instagram.getMedia "17895695668004550"

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/instagram";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  instagram.setToken "EAAG..."
  instagram.setBusinessAccount "EAAG..." "17841400123456"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/facebook — Facebook module for complementary functionality
• @robinpath/twitter — Twitter/X module for complementary functionality
• @robinpath/linkedin — LinkedIn module for complementary functionality
• @robinpath/tiktok — TikTok module for complementary functionality
• @robinpath/pinterest — Pinterest module for complementary functionality

License

MIT