Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

The Metricool node integrates with the Metricool social media management platform, enabling users to interact programmatically with various social media resources. Specifically, for the Instagram resource and the "Get Reels" operation, the node allows retrieving Instagram Reels data within a specified date range for a given Metricool brand account (identified by Blog ID).

This node is beneficial for social media managers and marketers who want to automate the extraction of Instagram Reels analytics or content data over time, facilitating reporting, performance tracking, or further processing in workflows.

Practical example:
A user can configure this node to fetch all Instagram Reels posted between January 1st and January 31st for their brand's Instagram account managed via Metricool. The retrieved data can then be used to analyze engagement trends or schedule follow-up posts.

Properties

Name Meaning
Blog ID The unique numeric identifier of the Metricool brand account from which to retrieve data.
Start Date The start date (inclusive) for fetching Instagram Reels content, formatted as YYYY-MM-DD.
End Date The end date (inclusive) for fetching Instagram Reels content, formatted as YYYY-MM-DD.

Output

  • The node outputs JSON data representing the Instagram Reels retrieved from the Metricool API for the specified blog account and date range.
  • Each item in the output array corresponds to a Reel or related data object returned by the API.
  • The exact structure depends on the Metricool API response but typically includes metadata such as Reel ID, publication date, engagement metrics, and media URLs.
  • This node does not output binary data.

Dependencies

  • Requires an active Metricool API key credential configured in n8n to authenticate requests.
  • The node makes HTTP requests to the Metricool API endpoint at https://api.metricool.com/v1.
  • No additional external dependencies are required beyond the Metricool API access.

Troubleshooting

  • Common issues:

    • Invalid or missing Blog ID may result in empty or error responses.
    • Incorrect date formats or invalid date ranges could cause API errors.
    • Network connectivity problems or expired API credentials will prevent successful data retrieval.

  • Error messages:

    • "Unknown resource: instagram" or "Unknown operation: getReels" indicates misconfiguration of resource or operation parameters.
    • API authentication errors suggest checking the validity and permissions of the provided API key.
    • If the node throws errors about request failures, verify that the Metricool service is reachable and the API limits have not been exceeded.

  • Resolution tips:

    • Ensure the Blog ID corresponds exactly to the Metricool brand account intended.
    • Use ISO date format (YYYY-MM-DD) for Start Date and End Date.
    • Confirm that the API key credential is correctly set up and has necessary permissions.
    • Enable "Continue On Fail" in the node settings if partial data retrieval is acceptable despite some errors.

Links and References

Discussion