Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This node integrates with the Metricool social media management platform to retrieve advertising campaign data, specifically Facebook Ads campaigns in this context. It allows users to fetch detailed campaign information within a specified date range for a given Metricool brand account (identified by a blog ID). This is useful for marketers and social media managers who want to automate the retrieval of Facebook ad campaign metrics and performance data for reporting or further analysis.

Practical examples:

  • Automatically pulling Facebook ad campaign data daily to update dashboards.
  • Integrating Facebook campaign metrics into broader marketing analytics workflows.
  • Scheduling reports that include Facebook ad performance over custom date ranges.

Properties

Name Meaning
Blog ID The unique identifier of the Metricool brand account (blog) from which to retrieve data.
Start Date The start date (YYYY-MM-DD) for the period to retrieve Facebook ads campaigns.
End Date The end date (YYYY-MM-DD) for the period to retrieve Facebook ads campaigns.

Output

The node outputs an array of JSON objects representing Facebook Ads campaigns retrieved from Metricool for the specified blog ID and date range. Each object contains campaign details as provided by the Metricool API, such as campaign names, IDs, statuses, and performance metrics.

If the node supports binary data output (not indicated here), it would typically represent media or report files related to campaigns, but this node focuses on JSON data output only.

Dependencies

  • Requires an active Metricool API key credential configured in n8n for authentication.
  • Relies on the Metricool REST API endpoint https://api.metricool.com/v1.
  • No additional external dependencies beyond the Metricool API and n8n's HTTP request helper.

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.
    • Request limits or API quota exceeded errors from Metricool.

  • Error messages:

    • "Unknown resource: advertising": Occurs if the resource parameter is misspelled or unsupported.
    • "Unknown operation: Get Facebook Ads Campaigns": Happens if the operation name does not match expected values.
    • Network or timeout errors indicate connectivity issues with the Metricool API.

  • Resolutions:

    • Verify and re-enter the API key credential.
    • Confirm the blog ID corresponds to an existing Metricool brand account.
    • Ensure dates are correctly formatted and logical (start before end).
    • Check Metricool API status and usage limits.

Links and References

Discussion