n8n-nodes-social-media-call

This is an n8n community node that provides a flexible API call interface for social media management platforms like Metricool, Buffer, Hootsuite, and others.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter n8n-nodes-social-media-call in Enter npm package name.
4. Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a public source.
5. Select Install.

After installing the node, you can use it like any other node in your workflows.

Manual Installation

To get started install the package in your n8n root directory:

npm install n8n-nodes-social-media-call

For Docker-based deployments add the following line before the font installation command in your n8n Dockerfile:

RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-social-media-call

Operations

This node provides a flexible interface to make API calls to any social media management platform. It supports:

HTTP Methods

• GET - Retrieve data
• POST - Create new resources
• PUT - Update resources (full replacement)
• PATCH - Update resources (partial update)
• DELETE - Delete resources

Request Features

• Custom Headers - Add authentication tokens, content types, etc.
• Query Parameters - Add URL parameters for filtering, pagination, etc.
• Request Body - Send JSON, form data, or raw content
• Response Formatting - Choose between JSON, string, or full response format
• Error Handling - Configurable error handling with detailed error information
• Timeout Control - Set custom timeout values
• SSL Options - Option to ignore SSL certificate validation
• Redirect Handling - Control whether to follow redirects

Credentials

You need to configure the Social Media Call API credentials with:

• API Key - Your platform's API key or access token
• Base URL - The base URL of the API (e.g., https://api.metricool.com/v1)
• Environment - Choose between Production and Sandbox

Usage Examples

1. Get Account Information

{
  "httpMethod": "GET",
  "endpoint": "/accounts",
  "sendQuery": true,
  "queryParameters": {
    "parameter": [
      {
        "name": "limit",
        "value": "10"
      }
    ]
  }
}

2. Create a Social Media Post

{
  "httpMethod": "POST",
  "endpoint": "/posts",
  "sendBody": true,
  "bodyType": "json",
  "bodyJson": "{\"platform\":\"facebook\",\"content\":\"Hello World!\",\"schedule_time\":\"2024-01-01T10:00:00Z\"}"
}

3. Get Analytics Data

{
  "httpMethod": "GET",
  "endpoint": "/analytics",
  "sendQuery": true,
  "queryParameters": {
    "parameter": [
      {
        "name": "platform",
        "value": "instagram"
      },
      {
        "name": "date_range",
        "value": "30d"
      },
      {
        "name": "metrics",
        "value": "impressions,reach,engagement"
      }
    ]
  }
}

4. Upload Media File

{
  "httpMethod": "POST",
  "endpoint": "/media/upload",
  "sendHeaders": true,
  "headers": {
    "header": [
      {
        "name": "Content-Type",
        "value": "multipart/form-data"
      }
    ]
  },
  "sendBody": true,
  "bodyType": "form",
  "bodyParameters": {
    "parameter": [
      {
        "name": "file",
        "value": "{{$binary.data}}"
      },
      {
        "name": "type",
        "value": "image"
      }
    ]
  }
}

Supported Platforms

This node can work with any social media management platform that provides a REST API, including:

• Metricool - Social media analytics and management
• Buffer - Social media scheduling and analytics
• Hootsuite - Social media management platform
• Sprout Social - Social media management and analytics
• Later - Visual social media scheduler
• SocialBee - Social media management tool
• Agorapulse - Social media management platform
• Custom APIs - Any REST API with proper authentication

Error Handling

The node provides comprehensive error handling:

• HTTP Status Codes - Captures and reports HTTP status codes
• Error Messages - Detailed error messages from the API
• Continue on Fail - Option to continue workflow execution even if requests fail
• Timeout Handling - Proper handling of request timeouts
• SSL Validation - Option to bypass SSL certificate validation for development

Response Formats

Choose how you want to receive the response data:

• JSON - Parse response as JSON object (default)
• String - Return response as string
• Full Response - Return complete HTTP response including headers, status code, etc.

Version History

1.0.0

• Initial release
• Support for all HTTP methods
• Flexible body and header configuration
• Query parameter support
• Multiple response format options
• Comprehensive error handling

Resources

• n8n community nodes documentation
• Metricool API Documentation
• Buffer API Documentation
• Hootsuite API Documentation

License

MIT

Support

If you have any issues or questions, please:

1. Check the n8n community forum
2. Review the API documentation for your specific platform
3. Open an issue on the GitHub repository

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.