Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This node integrates with the Metricool social media management platform, allowing users to interact with various social media resources such as Facebook, Instagram, TikTok, LinkedIn, and more. Specifically, for the Facebook resource and the Get Reels operation (though not explicitly shown in the code snippet, it falls under the Facebook resource operations), the node retrieves reels or video content data from a specified Facebook blog account within a given date range.

Common scenarios where this node is beneficial include:

  • Social media managers wanting to analyze or report on Facebook Reels performance over time.
  • Automating the retrieval of Facebook Reels data for further processing or integration into dashboards.
  • Scheduling or managing posts and analyzing best posting times across multiple platforms via Metricool.

Practical example:

  • A user wants to fetch all Facebook Reels posted between January 1, 2024, and January 31, 2024, for a specific brand's Facebook blog ID to analyze engagement metrics.

Properties

Name Meaning
Blog ID The numeric identifier of the Metricool brand account (Facebook blog) to retrieve reels from.
Start Date The start date (inclusive) for retrieving Facebook Reels content, formatted as YYYY-MM-DD.
End Date The end date (inclusive) for retrieving Facebook Reels content, formatted as YYYY-MM-DD.

Output

The node outputs JSON data representing the retrieved Facebook Reels content for the specified blog ID and date range. The structure typically includes details about each reel such as its metadata, timestamps, and possibly engagement statistics depending on Metricool's API response.

If binary data were involved (e.g., media files), it would be included in a binary property, but based on the provided code and operation, the output is JSON-only containing reel information.

Dependencies

  • Requires an active Metricool API key credential configured in n8n for authentication.
  • Relies on Metricool's REST API endpoint at https://api.metricool.com/v1.
  • The node uses the requestWithAuthentication helper method to handle authenticated HTTP requests to Metricool.

Troubleshooting

  • Common issues:

    • Invalid or missing Blog ID: Ensure the Blog ID corresponds to a valid Metricool brand account.
    • Date format errors: Dates must be in YYYY-MM-DD format; invalid formats may cause API errors.
    • Authentication failures: Verify that the Metricool API key credential is correctly set up and has necessary permissions.
    • Unknown resource or operation errors: These occur if unsupported resource or operation names are used.

  • Error messages:

    • "Unknown resource: facebook" or "Unknown operation: getReels": Indicates the node does not recognize the requested resource or operation; verify spelling and availability.
    • API request errors returned by Metricool will be surfaced; check the error message for details such as rate limits or permission issues.

Links and References

Discussion