Publer icon

Publer

Interact with the Publer API for social media management

Analytics → Get Post Insights

AI-generated

Overview

This node operation fetches post insights analytics for a specified social media account within a workspace. It allows users to retrieve detailed performance data about posts, filtered optionally by a date range and paginated by page index. This is useful for social media managers and marketers who want to analyze the effectiveness of their posts over time and optimize their content strategy accordingly.

Use Case Examples

  1. A social media manager wants to get insights on posts from a specific account to evaluate engagement metrics over the last month.
  2. A marketing analyst retrieves post insights data to generate reports on post performance trends for a client.

Properties

Name Meaning
Workspace The workspace context under which the analytics calls are made, used to scope the data retrieval.
Account The specific social media account for which post insights are requested. This is a required field.
Date Range An optional ISO date range filter (YYYY-MM-DD) to limit the insights data to posts within the specified time frame.
Page Zero-based page index to paginate through the post insights results.

Output

JSON

  • post_insights - Array of post insights data retrieved from the analytics endpoint, containing performance metrics for posts.

Dependencies

  • Requires an API key credential for authentication with the Publer API.

Troubleshooting

  • Ensure the 'Account' parameter is provided and valid, as it is required for the operation.
  • Verify that the 'Workspace' ID is correct and accessible with the provided API credentials.
  • Check the date range format to be valid ISO dates (YYYY-MM-DD) if used.
  • Pagination 'Page' parameter should be a non-negative integer; otherwise, the API may return errors or unexpected results.
  • Common error messages may include authentication failures if the API key is invalid or missing, or parameter validation errors if required fields are empty or incorrectly formatted.

Discussion