TheSocialWarehouse n8n Community Node

Connect n8n to TheSocialWarehouse API to automate social media data integration. This community node allows you to fetch profile information from platforms like Instagram, with plans for further expansion.

Features

• Instagram Profile Lookup: Retrieve comprehensive profile details (e.g., bio, follower count, avatar URL) using an Instagram username. Optionally provide a User ID for more robust lookups.
• Instagram User Search: Search for users by name using the User Finder tool.
• Instagram Media Posting: Upload profile pictures, standard feed posts, stories, and reels directly from n8n with caption, hashtag, and location controls.
• Instagram Media Engagement: Repost, like, comment, pin, or remove reels from the grid to orchestrate engagement workflows alongside posting.
• Trending Sounds & Music: Fetch currently Trending Sounds or perform a Sound Lookup using an audio ID to find the perfect track for your content.
• Inbox + Relationship Actions: Send DMs, manage follow/unfollow flows, and Block/Unblock accounts to maintain your account's social health.
• API Key Authentication: Securely authenticate with TheSocialWarehouse API using a dedicated API Key.
• Extensible Design: Built with a Resource/Operation pattern, enabling easy expansion to other social media platforms (e.g., TikTok, Threads) and additional API operations in future releases.

Installation

There are three ways to install this community node in n8n:

Option 1: Install via n8n UI (Recommended)

The easiest method for most users:

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Click Install
4. Enter n8n-nodes-thesocialwarehouse
5. Click Install
6. Restart n8n when prompted

Option 2: Manual Installation (npm)

For self-hosted n8n instances:

# Install the package in n8n's custom nodes directory
cd ~/.n8n/nodes
npm install n8n-nodes-thesocialwarehouse

Then restart your n8n instance.

Option 3: Docker Installation

For n8n running in Docker:

# Access your Docker container shell
docker exec -it n8n sh

# Create the nodes directory if it doesn't exist
mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes

# Install the package
npm install n8n-nodes-thesocialwarehouse

# Exit the container
exit

Then restart your n8n container:

docker restart n8n

Verify Installation

After installation and restart, the TheSocialWarehouse node should appear when you search for nodes in your workflow editor.

Credentials Setup

To use the TheSocialWarehouse node, you need to configure your API Key:

1. In your n8n editor, click on "Credentials" in the left sidebar.
2. Click "New Credential".
3. Search for and select "TheSocialWarehouse API".
4. Enter your API Key, which you can obtain from your TheSocialWarehouse dashboard.
5. Save the credential.

The API Key is sent via the X-Insta-Api-Client header for Instagram-related requests.

Usage Example: Instagram - Get Profile

Here's how to use the TheSocialWarehouse node to get an Instagram user's profile:

1. Add the Node: In your n8n workflow, add a "TheSocialWarehouse" node (search for "TheSocialWarehouse").
2. Configure Credentials: Select your configured "TheSocialWarehouse API" credential.
3. Select Resource & Operation:
   • Set Resource to Instagram.
   • Set Operation to Get Profile.
4. Enter Account Details:
   • Account Username: Enter the Instagram username (e.g., therock). This is a required path parameter.
   • User ID (Optional): Optionally, enter the Instagram user ID (e.g., 232192182 for therock). This is sent as a query parameter (user_id).
5. Execute Workflow: Run the workflow. The node will return the JSON response containing the Instagram profile data.

Development

• npm run dev: Start n8n with hot-reloading for development.
• npm run build: Compile the TypeScript code to the dist/ directory and copy to n8n custom nodes.
• npm run lint: Lint the codebase for style and errors.

Contributing

Contributions are welcome! Please refer to the CODE_OF_CONDUCT.md and CONTRIBUTING.md (if it exists) for guidelines.