Upload Post icon

Upload Post

Upload content to social media via Upload-Post API

Actions28

Status & History → Get Total Impressions

AI-generated

Overview

This node operation retrieves the total impressions aggregated across connected social media platforms for a specified profile username and date range. It supports filtering by preset periods or custom start and end dates, and can restrict the data to selected platforms. Additionally, it can return impressions either as a single total or broken down per platform. This is useful for social media managers or marketers who want to analyze the reach of a profile's content over time across multiple platforms.

Use Case Examples

  1. A social media manager wants to get the total impressions for a client's Instagram and Facebook profiles over the last month to evaluate campaign performance.
  2. A marketer needs to retrieve impressions data broken down by platform for a specific profile username for a custom date range to report on multi-platform engagement.

Properties

Name Meaning
Profile Username Profile username to aggregate impressions for, required to specify which profile's impressions to retrieve.
Period Preset date range for the impressions data. If left empty, custom start and end dates are used, or defaults to the last 30 days if none set.
Start Date Start date of a custom date range in YYYY-MM-DD format. Ignored if Period is set.
End Date End date of a custom date range in YYYY-MM-DD format. Ignored if Period is set.
Platforms List of social media platforms to restrict the impressions aggregation to. If empty, impressions from all platforms are included.
Breakdown Boolean flag indicating whether to return impressions broken down per platform instead of a single total.

Output

JSON

  • json - The JSON response containing total impressions data aggregated for the specified profile and date range, optionally broken down by platform.

Dependencies

  • Upload-Post API key credential

Troubleshooting

  • Ensure the 'Profile Username' is correctly specified and exists in the connected Upload-Post account.
  • If using Facebook platform, ensure the required Page ID is provided if applicable (not directly relevant for impressions but may affect related analytics).
  • Verify that the selected platforms are valid and supported by the Upload-Post API.
  • Check that the date formats for custom start and end dates are correct (YYYY-MM-DD).
  • If no data is returned, verify that the profile has impressions data for the specified period and platforms.

Links

Discussion