Overview
This node integrates with the ContentStudio API to manage social media posts within a specified workspace. The Post - List operation retrieves a paginated list of posts from a given workspace, optionally filtered by post statuses and date ranges.
Typical use cases include:
- Fetching recent or scheduled social media posts for reporting or monitoring.
- Automating workflows that need to process or analyze posts based on their status (e.g., published, scheduled).
- Synchronizing posts data with other systems or dashboards.
For example, you could use this node to list all published posts in a workspace during the last month or retrieve queued posts awaiting publication.
Properties
| Name | Meaning |
|---|---|
| Workspace ID | The identifier of the workspace from which to list posts. |
| Page | The page number of results to retrieve (pagination). Minimum is 1. |
| Per Page | Number of posts to return per page. Minimum 1, maximum 100. |
| Statuses (CSV) | Comma-separated list of post statuses to filter by, e.g., scheduled,published,queued. |
| Date From | Start date (inclusive) to filter posts by creation or scheduling date, format YYYY-MM-DD. |
| Date To | End date (inclusive) to filter posts by creation or scheduling date, format YYYY-MM-DD. |
Output
The output is an array of JSON objects representing posts retrieved from the ContentStudio API. Each object contains the full details of a post as returned by the API, including but not limited to:
- Post content (text, media)
- Post status
- Scheduling information
- Associated social accounts
- Metadata such as creation and update timestamps
The node does not output binary data for this operation.
Dependencies
- Requires an API key credential for authenticating with the ContentStudio API.
- The node uses the ContentStudio API base URL and expects network access to it.
- Pagination parameters (
pageandperPage) control the amount of data fetched per request.
Troubleshooting
- Empty results: Ensure the
Workspace IDis correct and that posts exist matching the filters (statuses, dates). - Invalid date format: The
Date FromandDate Tofields must be inYYYY-MM-DDformat; otherwise, the API may reject the request or return no results. - API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Rate limits or timeouts: Large
perPagevalues or many pages might cause delays or rate limiting; try reducing the page size or adding delays between executions.
Links and References
- ContentStudio API Documentation (for detailed API endpoints and data structures)
- ContentStudio Official Website