Publer icon

Publer

Interact with the Publer API for social media management

Actions25

Analytics → Get Hashtag Performing Posts

AI-generated

Overview

This node operation fetches posts that are performing well for a specific hashtag within a given social media account. It is useful for social media managers and marketers who want to analyze the effectiveness of hashtag campaigns by identifying top-performing posts associated with a hashtag. For example, a user can specify a hashtag, account, and optional date range to retrieve posts that have high engagement or reach, helping to optimize future content strategies.

Use Case Examples

  1. Retrieve top-performing posts for the hashtag #marketing on a specific Instagram account to analyze which posts gained the most engagement.
  2. Fetch posts tagged with #summer2024 within a date range to evaluate seasonal campaign success.

Properties

Name Meaning
Workspace Workspace context for analytics calls, used to scope the API request to a specific workspace.
Account The social media account to query for hashtag performing posts, required to specify which account's data to analyze.
Hashtag The hashtag including the # prefix to filter posts by, required to specify which hashtag's performing posts to retrieve.
Date Range Optional ISO date range filter (YYYY-MM-DD) to limit the posts retrieved to a specific time period.
Page Zero-based page index for paginated results, allowing retrieval of subsequent pages of data.

Output

JSON

  • id - Unique identifier of the post
  • content - Content or text of the post
  • engagementMetrics
    • likes - Number of likes the post received
    • comments - Number of comments the post received
    • shares - Number of shares or reposts
  • timestamp - Date and time when the post was published
  • author
    • id - Identifier of the post author
    • name - Name of the post author

Dependencies

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

Troubleshooting

  • Ensure the 'Account' parameter is provided and valid, as it is required for the API call.
  • Verify the 'Hashtag' parameter includes the '#' prefix and is not empty to avoid errors.
  • Check that the date range, if provided, is in the correct ISO format (YYYY-MM-DD).
  • If pagination is used, ensure the 'Page' parameter is a non-negative integer.
  • Common error messages may include invalid workspace or account IDs, missing required parameters, or API authentication failures. Verify credentials and parameter values accordingly.

Links

  • Publer API Documentation - Official API documentation for Publer, detailing endpoints and parameters including analytics and hashtag performing posts.

Discussion