Metricool icon

Metricool

Interact with Metricool social media management platform

Actions25

Overview

The Metricool node integrates with the Metricool social media management platform, enabling users to interact programmatically with various social media resources such as Pinterest, Instagram, Facebook, and others. Specifically, for the Pinterest - Get Pins operation, this node retrieves pins data from a specified Metricool brand account within a defined date range.

This operation is useful for social media managers or marketers who want to automate the extraction of Pinterest pin analytics or content data over a specific period. For example, you could use it to gather performance metrics of pins posted between two dates to analyze engagement trends or to generate reports.

Properties

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

Output

The output is a JSON array containing the retrieved pins data from the specified Metricool brand account within the given date range. Each item in the array represents a pin with its associated details as provided by the Metricool API.

  • The exact structure of each pin object depends on the Metricool API response but typically includes information such as pin ID, description, image URLs, engagement metrics, timestamps, and other metadata.
  • This node does not output binary data.

Dependencies

  • Requires an active Metricool API key credential configured in n8n to authenticate requests.
  • The node makes HTTP requests to the Metricool API endpoint at https://api.metricool.com/v1.
  • Proper configuration of the Metricool brand account (Blog ID) is necessary to retrieve relevant data.

Troubleshooting

  • Common Issues:

    • Invalid or missing Blog ID: Ensure the Blog ID corresponds to a valid Metricool brand account.
    • Incorrect date formats: Dates must be in YYYY-MM-DD format; otherwise, the API may reject the request.
    • Authentication errors: Verify that the Metricool API key credential is correctly set up and has sufficient permissions.
    • API rate limits or downtime: If requests fail repeatedly, check Metricool service status or API usage limits.

  • Error Messages:

    • "Unknown resource: pinterest" or "Unknown operation: getPins": Indicates a misconfiguration of resource or operation parameters.
    • Network or authentication errors will typically include messages about failed requests or unauthorized access; recheck credentials and network connectivity.

Links and References

Discussion