Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This node integrates with the Metricool social media management platform, enabling users to interact programmatically with various Metricool resources. Specifically, for the Advertising resource and the Get Google Ads Campaigns operation, it retrieves advertising campaign data from Metricool within a specified date range.

Typical use cases include:

  • Fetching Google Ads campaign performance data for reporting or analytics.
  • Automating campaign data retrieval to integrate with other marketing tools or dashboards.
  • Monitoring advertising campaigns over time by specifying start and end dates.

For example, a user can set the blog ID of their Metricool brand account along with a date range to pull all Google Ads campaigns active during that period.

Properties

Name Meaning
Blog ID The numeric identifier of the Metricool brand account (blog) whose campaigns to retrieve.
Start Date The start date (YYYY-MM-DD) from which to begin retrieving campaigns.
End Date The end date (YYYY-MM-DD) up to which to retrieve campaigns.

Output

The node outputs an array of JSON objects representing the retrieved Google Ads campaigns. Each object contains campaign details as provided by the Metricool API, such as campaign names, IDs, performance metrics, and other relevant data fields.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Metricool API key credential configured in n8n for authentication.
  • Relies on the Metricool API endpoint https://api.metricool.com/v1 to fetch advertising campaign data.
  • The node uses HTTP requests authenticated via the stored API key to communicate with Metricool.

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 the start or end dates are not in YYYY-MM-DD format.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Unknown resource: advertising": Indicates the resource parameter was not recognized; ensure "Advertising" is selected.
    • "Unknown operation: getGoogleAdsCampaigns": Means the operation name is incorrect or unsupported.
    • API errors returned from Metricool (e.g., unauthorized, bad request) will be passed through; verify API key validity and input parameters.

  • Resolutions:

    • Double-check API credentials and permissions.
    • Validate input parameters, especially blog ID and date formats.
    • Ensure network access to Metricool's API endpoint.
    • Use the node’s "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion