Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

The node integrates with the Metricool social media management platform, enabling users to interact with various social media resources such as Facebook, Instagram, TikTok, LinkedIn, and more. Specifically, for the Facebook - Get Stories operation, it retrieves story content data from a specified Facebook brand account within a given date range.

This node is beneficial for social media managers and marketers who want to automate the retrieval of Facebook story analytics or content data for reporting, analysis, or further processing workflows. For example, you can use it to fetch all Facebook stories posted by a brand between two dates to analyze engagement or performance trends.

Properties

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

Output

The node outputs JSON data representing the Facebook stories retrieved from the Metricool API for the specified brand and date range. Each item in the output array corresponds to a story with its associated metadata and content details as provided by Metricool.

  • The json output field contains an array of story objects.
  • No binary data output is indicated for this operation.

Dependencies

  • Requires an active Metricool API key credential configured in n8n for authentication.
  • The node makes HTTP requests to the Metricool API endpoint at https://api.metricool.com/v1.
  • Proper permissions on the Metricool account to access Facebook brand data are necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect Blog ID may result in empty or error responses.
    • Date format errors if Start Date or End Date are not in YYYY-MM-DD format.
    • Network connectivity issues affecting API calls.

  • Error messages:

    • "Unknown resource: facebook" or "Unknown operation: getStories" indicate misconfiguration of resource or operation parameters.
    • API errors returned from Metricool will be included in the node's error output if "Continue On Fail" is enabled.

  • Resolutions:

    • Verify that the API key credential is correctly set up and has required permissions.
    • Double-check the Blog ID corresponds to the correct Facebook brand account.
    • Ensure date inputs follow the required format.
    • Enable "Continue On Fail" to handle partial failures gracefully in batch executions.

Links and References

Discussion