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 TikTok Ads Campaigns operation, it retrieves TikTok advertising campaign data within a specified date range for a given Metricool brand account (identified by a blog ID).

This functionality is useful for marketers and social media managers who want to automate the extraction of TikTok ad campaign performance data for reporting, analysis, or integration into other workflows.

Practical example:
A user can set up this node to fetch all TikTok ad campaigns run between two dates for a specific brand, then use the output data to generate custom reports or feed it into a dashboard for monitoring campaign effectiveness.

Properties

Name Meaning
Blog ID The unique identifier of the Metricool brand account (blog) from which to retrieve data.
Start Date The start date (inclusive) for retrieving TikTok ad campaigns, formatted as YYYY-MM-DD.
End Date The end date (inclusive) for retrieving TikTok ad campaigns, formatted as YYYY-MM-DD.

Output

The node outputs an array of JSON objects representing TikTok ad campaigns retrieved from Metricool for the specified blog ID and date range. Each object contains campaign details as provided by the Metricool API.

  • The json field includes campaign metadata such as campaign names, IDs, dates, and performance metrics.
  • No binary data output is indicated in the source code.

Dependencies

  • Requires an active connection to the Metricool API via an API key credential configured in n8n.
  • The node uses Metricool's REST API endpoint at https://api.metricool.com/v1.
  • Proper permissions on the Metricool account to access advertising campaign 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 (not using YYYY-MM-DD) might cause request failures.
    • Network connectivity issues can prevent successful API calls.

  • Error messages:

    • "Unknown resource: advertising" — indicates the resource parameter was not recognized; ensure "Advertising" is selected.
    • "Unknown operation: getTikTokAdsCampaigns" — indicates the operation parameter is invalid or misspelled.
    • API errors returned from Metricool will be surfaced; check the error message for details like rate limits or permission issues.

  • Resolution tips:

    • Verify API credentials and permissions.
    • Double-check input parameters for correct types and formats.
    • Use the node’s "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion