Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This node integrates with the Metricool social media management platform, specifically enabling users to retrieve posts from the X (Twitter) resource. The "Get Posts" operation allows fetching posts within a specified date range for a given blog ID associated with a Metricool brand account.

Typical use cases include:

  • Analyzing Twitter post performance over a specific period.
  • Archiving or exporting tweets posted by a brand.
  • Automating reporting workflows that require historical Twitter data.

For example, a social media manager could use this node to pull all tweets published between January 1 and January 31 for their brand's Twitter account to analyze engagement trends.

Properties

Name Meaning
Blog ID The numeric identifier of the Metricool brand account (blog) whose posts are retrieved.
Start Date The start date (inclusive) for retrieving posts, formatted as YYYY-MM-DD.
End Date The end date (inclusive) for retrieving posts, formatted as YYYY-MM-DD.

Output

The node outputs an array of JSON objects representing the posts retrieved from the Metricool API for the specified blog ID and date range. Each object corresponds to a single post with details as provided by Metricool's API response.

The exact structure of each post object depends on Metricool's API but typically includes fields such as post content, publication date, engagement metrics, and possibly metadata about the post's status or platform.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Metricool API key credential configured in n8n to authenticate requests.
  • The node makes HTTP requests to Metricool's API endpoint at https://api.metricool.com/v1.
  • Proper network connectivity to Metricool's API service is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect blog ID may result in empty responses or errors.
    • Date format errors (not using YYYY-MM-DD) can lead to request rejections.
    • Network issues or API downtime can cause request failures.

  • Error Messages:

    • "Unknown resource: twitter": Indicates the resource parameter was not set correctly; ensure "X (Twitter)" is selected.
    • "Unknown operation: getPosts": Means the operation name is incorrect or unsupported; verify operation spelling and availability.
    • Authentication errors usually mention invalid credentials or unauthorized access; check API key validity.

  • Resolution Tips:

    • Double-check the blog ID against your Metricool account.
    • Ensure dates are properly formatted and logical (start date before end date).
    • Confirm API key permissions and that it is correctly configured in n8n.
    • Use the node's "Continue On Fail" option to handle intermittent API errors gracefully.

Links and References

Discussion