Postiz icon

Postiz

Consume Postiz API

Get Posts

AI-generated

Overview

This node operation retrieves a list of posts from the Postiz API filtered by a specified date range and optionally by a customer ID. It is useful for scenarios where users need to fetch posts created within a certain time frame, such as generating reports, monitoring content, or syncing posts with other systems.

Use Case Examples

  1. Fetch all posts created between January 1, 2023, and January 31, 2023.
  2. Retrieve posts for a specific customer within a given date range.

Properties

Name Meaning
Start Date (UTC) Start date for filtering posts (UTC). This is a required parameter to specify the beginning of the date range for the posts to retrieve.
End Date (UTC) End date for filtering posts (UTC). This is a required parameter to specify the end of the date range for the posts to retrieve.
Customer Customer ID for filtering posts. This is an optional parameter to narrow down the posts to those associated with a specific customer.

Output

JSON

  • id - Unique identifier of the post
  • type - Type of the post (e.g., draft, schedule, now)
  • shortLink - Indicates if short links are used in the post
  • date - Date and time of the post
  • tags - Tags associated with the post, each with a value and label
  • posts
    • integration
      * id - ID of the channel integration
    • group - Group name of the post
    • settings - Settings for the post with various value types (string, number, boolean, JSON)
    • value
      * content - Content text of the content item
      * id - Optional content ID
      * image - Images associated with the content item, each with an ID and path

Dependencies

  • Postiz API key credential

Troubleshooting

  • Ensure the start and end dates are provided and correctly formatted in UTC to avoid API errors.
  • If filtering by customer ID, verify the ID is correct and exists in the Postiz system.
  • Handle API errors gracefully, especially network issues or invalid parameters, by enabling 'Continue On Fail' to process partial data.

Discussion