Publer icon

Publer

Interact with the Publer API for social media management

Actions25

Media → List

AI-generated

Overview

This node interacts with the Publer API to list media items within a specified workspace. It allows users to filter media by type (photo, video, GIF, link, status), usage status (used or unused), and supports pagination through a zero-based page index. This operation is useful for managing and retrieving media assets stored in a Publer workspace, enabling automation workflows that require media data retrieval, such as content scheduling or media analysis.

Use Case Examples

  1. Retrieve all photos and videos from a specific workspace's media library.
  2. List only unused media items to identify assets available for new posts.
  3. Paginate through media items to process large media libraries in batches.

Properties

Name Meaning
Workspace The workspace that owns the media library. Defaults to the workspace configured in the credentials.
Filters Filters to narrow down the media list results.

Output

JSON

  • id - Unique identifier of the media item.
  • type - Type of the media item (e.g., photo, video).
  • url - URL of the media item.
  • name - Name or title of the media item.
  • used - Indicates if the media item is used or unused.
  • page - Page index of the media list result, useful for pagination.

Dependencies

  • Requires an API key credential for Publer API authentication.

Troubleshooting

  • Ensure the workspace ID is valid and accessible with the provided credentials.
  • Verify that the filter parameters are correctly formatted and valid.
  • Handle pagination carefully to avoid missing or duplicating media items.
  • Common error: 'Parameter "workspaceId" is empty' - ensure the workspace is selected or configured in credentials.
  • Common error: API request failures due to invalid or expired API key - refresh or reconfigure credentials.

Links

Discussion