Actions8
Overview
The node "VistaSocial" integrates with the Vista Social platform to retrieve various types of social media data. Specifically, for the Report resource and the Get Daily Metrics operation, it fetches daily aggregated metrics data within a specified date range for a given profile. This is useful for users who want to analyze performance trends over time, such as tracking engagement, reach, or other key metrics on their social media profiles.
Practical examples include:
- Generating daily performance reports for a marketing campaign.
- Monitoring social media growth or decline over a specific period.
- Comparing daily metrics across different profiles or accounts.
Properties
| Name | Meaning |
|---|---|
| Date From | The start date (inclusive) from which to retrieve daily metrics. |
| Date To | The end date (inclusive) up to which to retrieve daily metrics. |
| Profile ID | The unique identifier of the social media profile for which the metrics are requested. |
Output
The node outputs JSON data containing the daily metrics for the specified profile between the given dates. Each item in the output typically represents one day's worth of aggregated data, including various performance indicators such as impressions, clicks, engagements, etc., depending on what Vista Social provides.
If the node supports binary data output (not evident from the provided code), it would likely be related to report files or exports, but this is not indicated here.
Dependencies
- Requires an API key credential for authenticating with the Vista Social API.
- The base URL for API requests is
https://vistasocial.com/api/integration. - Proper configuration of the API credential in n8n is necessary to access the service.
Troubleshooting
- Missing or invalid API credentials: Ensure that the API key is correctly set up in n8n credentials; otherwise, authentication errors will occur.
- Invalid date range: The "Date From" must be before or equal to "Date To". Providing an invalid range may cause the API to return errors or empty results.
- Incorrect Profile ID: Using a non-existent or unauthorized profile ID will result in no data or error responses.
- API rate limits or downtime: If the Vista Social API is temporarily unavailable or rate-limited, the node will fail to retrieve data.
Common error messages might include authentication failures, invalid parameters, or network issues. Checking the API key validity, input parameters, and network connectivity usually resolves these.
Links and References
- Vista Social API Documentation (general reference based on baseURL)
- n8n documentation on creating custom nodes for further customization guidance