Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This node integrates with the Metricool social media management platform to retrieve analytics data for various social networks. Specifically, the "Get Analytics" operation under the "Analytics" resource allows users to fetch detailed metrics over a specified date range for a given social media network and blog account.

Common scenarios where this node is beneficial include:

  • Monitoring social media performance by extracting follower counts, likes, comments, and other engagement metrics.
  • Generating reports on social media activity within a custom workflow.
  • Automating data collection for marketing dashboards or analytics tools.

For example, a user can configure the node to get Instagram analytics from January 1st to January 31st in the Europe/Madrid timezone, retrieving metrics such as followers, likes, and comments for a specific blog ID.

Properties

Name Meaning
Network The social media network to retrieve analytics for. Options: Bluesky, Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, Twitch, Twitter/X, YouTube.
Blog ID Numeric identifier of the Metricool brand account (blog) for which to get analytics.
Start Date Start date of the analytics data range (format: YYYY-MM-DD).
End Date End date of the analytics data range (format: YYYY-MM-DD).
Timezone Timezone for the date range, e.g., "Europe/Madrid".
Metrics List of metric names to retrieve. Multiple values allowed. Example metrics include followers, likes, comments.

Output

The node outputs JSON data containing the requested analytics metrics for the specified network and blog ID over the selected date range. The exact structure depends on the Metricool API response but generally includes time-series or aggregated values for each requested metric.

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 REST API endpoint at https://api.metricool.com/v1.
  • Proper timezone formatting is necessary to ensure accurate date range queries.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect blog ID or network selection may result in empty or error responses.
    • Date format errors or invalid date ranges can lead to request rejections.
    • Requesting unsupported metrics (not available via the "Get Metrics" operation) may cause errors.

  • Error Messages:

    • "Unknown resource: analytics" or "Unknown operation: getAnalytics" indicates misconfiguration of resource or operation parameters.
    • API errors returned from Metricool typically include HTTP status codes and messages; verify credentials and parameter correctness.
    • If the node throws errors related to date parsing, ensure dates are in the correct YYYY-MM-DD format and timezone is valid.

Links and References

Discussion