Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

This node interacts with the Metricool social media management platform to retrieve the best times to post content on various social media platforms. Specifically, the "Get Best Time to Post" operation analyzes historical data within a specified date range and timezone to suggest optimal posting times for a given social media provider (e.g., Instagram, Facebook, Twitter). This helps users maximize engagement by scheduling posts when their audience is most active.

Common scenarios:

  • Social media managers wanting to optimize post timing for increased reach and interaction.
  • Marketing teams analyzing past performance to plan future content calendars.
  • Automated workflows that schedule posts at recommended times based on data-driven insights.

Practical example:
A user wants to find the best times to post on Instagram for their brand's blog between January 1, 2024, and January 31, 2024, in the Europe/Madrid timezone. They provide the blog ID and request the best posting times for Instagram during this period. The node returns time slots where posts are likely to perform best.

Properties

Name Meaning
Blog ID The numeric identifier of the Metricool brand account (blog) to analyze.
Provider The social media platform to get optimal posting times for. Options: Facebook, Instagram, LinkedIn, TikTok, Twitter, YouTube.
Start Date The start date of the analysis period in YYYY-MM-DD format.
End Date The end date of the analysis period in YYYY-MM-DD format.
Timezone The timezone for the analysis, e.g., Europe/Madrid.

Output

The node outputs JSON data containing the best times to post on the selected social media platform within the specified date range and timezone. The exact structure depends on the Metricool API response but typically includes:

  • Suggested time slots or hours considered optimal for posting.
  • Possibly additional metadata such as engagement metrics or confidence scores.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Metricool account with API access.
  • Needs an API key credential configured in n8n for authenticating requests to the Metricool API.
  • The node makes HTTP requests to https://api.metricool.com/v1/post/best-time.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect blog ID or provider values may result in empty or error responses.
    • Date formats must be valid ISO dates; otherwise, the API may reject the request.
    • Timezone strings must follow recognized IANA timezone names (e.g., Europe/Madrid).

  • Error messages:

    • "Unknown post operation: getBestTimeToPost": Indicates a misconfiguration in the operation name.
    • API errors related to invalid parameters or authentication will be returned from Metricool and surfaced by the node.

  • Resolutions:

    • Verify API credentials and permissions.
    • Double-check input property values for correctness.
    • Ensure date and timezone formats conform to expected standards.

Links and References

Discussion