Actions25
- Advertising Actions
- Analytics Actions
- Bluesky Actions
- Competitor Actions
- Facebook Actions
- Instagram Actions
- LinkedIn Actions
- Pinterest Actions
- Post Actions
- Thread Actions
- TikTok Actions
- Twitch Actions
- X (Twitter) Actions
- YouTube Actions
Overview
This node integrates with the Metricool social media management platform to retrieve scheduled posts for a specified blog within a given date range. It is useful for users who want to programmatically access their upcoming social media content schedules, enabling automation workflows such as reporting, auditing, or syncing scheduled posts with other tools.
A practical example would be fetching all scheduled posts between two dates for a particular blog account to generate a content calendar report or to trigger notifications before posts go live.
Properties
| Name | Meaning |
|---|---|
| Blog ID | The unique identifier of the Metricool blog (brand account) from which to fetch posts. |
| Start Date | The start date (inclusive) for retrieving scheduled posts, formatted as YYYY-MM-DD. |
| End Date | The end date (inclusive) for retrieving scheduled posts, formatted as YYYY-MM-DD. |
| Timezone | The timezone context for the date range, e.g., "Europe/Madrid". |
Output
The node outputs an array of JSON objects representing the scheduled posts retrieved from Metricool. Each object contains details about individual scheduled posts within the specified date range and blog.
The exact structure depends on Metricool's API response but typically includes fields such as post content, scheduled date/time, platforms/networks targeted, media URLs, and post identifiers.
No binary data output is produced by this operation.
Dependencies
- Requires an active Metricool API key credential configured in n8n.
- The node makes authenticated HTTP requests to Metricool's API endpoint at
https://api.metricool.com/v1. - Proper timezone strings must be provided to ensure correct date filtering.
Troubleshooting
Common Issues:
- Invalid or missing Blog ID will cause the API call to fail or return no results.
- Incorrect date formats or invalid timezone strings may lead to errors or empty responses.
- Network or authentication failures if the API key is invalid or expired.
Error Messages:
"Unknown post operation: getScheduledPosts"indicates a misconfiguration of the operation parameter.- API errors returned from Metricool will be surfaced; check the error message for details.
Resolutions:
- Verify that the Blog ID corresponds to an existing Metricool brand account.
- Ensure dates are correctly formatted as ISO date strings (YYYY-MM-DD).
- Confirm the timezone string matches valid IANA timezone names.
- Check that the API key credential is correctly set up and has necessary permissions.
Links and References
- Metricool API Documentation (Note: link is illustrative; verify actual URL)
- IANA Time Zone Database for valid timezone strings