Skip to main content
GET
/
posts-bulk
Get posts by IDs
curl --request GET \
  --url https://api.postflow.app/v1/posts-bulk \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "public_id": "<string>",
    "organization_id": "<string>",
    "user_id": "<string>",
    "post_id": "<string>",
    "cu_task_id": "<string>",
    "name": "<string>",
    "status": 1,
    "note": "<string>",
    "visible_for_client": true,
    "content": "<string>",
    "content_weighted_length": 123,
    "has_customized_content": true,
    "locations": [
      {
        "id": "<string>",
        "name": "<string>",
        "location": [
          "<string>"
        ],
        "network": "twitter",
        "followers_count": 123,
        "username": "<string>"
      }
    ],
    "image_tags": [
      {
        "id": "<string>",
        "media_id": "<string>",
        "network": "twitter",
        "x": 123,
        "y": 123,
        "mode": "user",
        "username": "<string>",
        "social_account_id": "<string>",
        "product": [
          "<string>"
        ]
      }
    ],
    "selected_media_ids": [
      "<string>"
    ],
    "first_comments": {
      "enabled": true,
      "socialAccountIds": [
        "<string>"
      ],
      "conditionType": 1,
      "conditionValue": 123,
      "content": "<string>",
      "customized": {
        "linkedin": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        },
        "instagram": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        },
        "facebook": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        },
        "youtube": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        },
        "threads": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        },
        "bluesky": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        },
        "twitter": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionType": 1,
          "conditionValue": 123,
          "content": "<string>"
        }
      }
    },
    "publication_date": "2023-11-07T05:31:56Z",
    "publication_timestamp": 123,
    "customized_publication_date": [
      "<string>"
    ],
    "publication_delay_between": 123,
    "fb_post_type": 1,
    "fb_video_title": "<string>",
    "ig_post_type": 1,
    "ig_collaborators": [
      "<string>"
    ],
    "ig_share_to_feed": true,
    "ig_allow_comments": true,
    "ig_audio_name": "<string>",
    "li_post_type": 1,
    "li_carousel_title": "<string>",
    "li_poll": {
      "question": "<string>",
      "option_1": "<string>",
      "option_2": "<string>",
      "option_3": "<string>",
      "option_4": "<string>",
      "duration": "ONE_DAY"
    },
    "tt_post_type": 1,
    "tt_privacy_level": 1,
    "tt_carousel_title": "<string>",
    "tt_disable_duet": true,
    "tt_disable_stitch": true,
    "tt_disable_comment": true,
    "tt_brand_content": true,
    "tt_brand_organic": true,
    "tt_auto_music": true,
    "tt_is_aigc": true,
    "pi_pin_title": "<string>",
    "pi_url_link": "<string>",
    "pi_boards": [
      "<string>"
    ],
    "pi_sections": [
      "<string>"
    ],
    "pi_is_standard_pin": true,
    "gb_post_type": 1,
    "gb_event_title": "<string>",
    "gb_start_date": "2023-11-07T05:31:56Z",
    "gb_end_date": "2023-11-07T05:31:56Z",
    "gb_use_time": true,
    "gb_action_type": 1,
    "gb_action_url": "<string>",
    "gb_coupon_code": "<string>",
    "gb_redeem_url": "<string>",
    "gb_term_conditions": "<string>",
    "yt_post_type": 1,
    "yt_video_title": "<string>",
    "yt_video_tags": [
      "<string>"
    ],
    "yt_categories": [
      "<string>"
    ],
    "yt_playlists": [
      "<string>"
    ],
    "yt_privacy_level": 1,
    "yt_license": 1,
    "yt_embeddable": true,
    "yt_notify_subscribers": true,
    "yt_made_for_kids": true,
    "dr_title": "<string>",
    "dr_tags": [
      "<string>"
    ],
    "tw_post_type": 1,
    "tw_poll": [
      "<string>"
    ],
    "tw_reply_settings": 1,
    "th_post_type": 1,
    "th_poll": [
      "<string>"
    ],
    "th_topic_tag": "<string>",
    "customized": {},
    "is_publicly_shared": true,
    "guest_approver_name": "<string>",
    "everyone_must_approve": true,
    "should_skip": true,
    "approved_at": "2023-11-07T05:31:56Z",
    "published_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "user": {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>",
      "phone": "<string>",
      "inviter_id": "<string>",
      "organization_id": "<string>",
      "role": "owner",
      "is_client": true,
      "can_approve": true,
      "can_connect_account": true,
      "can_access_all_groups": true,
      "self_approval": true,
      "time_format_24": true,
      "week_start_day": 0,
      "date_format": 1,
      "color": 1,
      "avatar": "<string>",
      "invited_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "open_cu_links_in_app": false,
      "groupIds": []
    },
    "socialAccounts": [],
    "comments": [],
    "tasks": [],
    "details": [],
    "media": [],
    "labels": [],
    "approvals": [],
    "selectedAccountIds": [],
    "assigneesIds": [],
    "source": 1,
    "cu_creator_name": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
ids
string
required

Post IDs separated by comma. Max 200 posts per request.

Response

The collection of PostData

​
id
string
required
​
public_id
string
required

If is_publicly_shared is true, you can use this ID to construct a link for public sharing.

https://new.postflow.app/p/PUBLIC_ID

​
organization_id
string
required
​
user_id
string | null
required

The ID of the user who created the post

​
post_id
string | null
required
​
cu_task_id
string | null
required

The ClickUp task ID associated with this PostFlow post.

Available only if you have an active ClickUp integration

​
name
string | null
required

Post name for better visibility. Only for internal post annotation in PostFlow

​
status
enum<integer>
required

1 NotSchedule
5 Draft
10 InReview
15 ReviewRejected
20 ReviewMissed
25 Scheduled
30 InProgress
35 Failed
37 Skipped
40 Published
50 Deleted

Available options:
1,
5,
10,
15,
20,
25,
30,
35,
37,
40,
50
​
note
string | null
required

Internal note for the post

​
visible_for_client
boolean
required
​
content
string | null
required
​
content_weighted_length
integer
required

The content length calculated using weighted character counting, where some characters (such as emojis or certain Unicode characters) may count as multiple characters

​
has_customized_content
boolean
required

Indicates whether the content is customized for some social networks

​
locations
MetaPageLocationData · object[]
required
​
image_tags
MediaTagData · object[]
required
​
selected_media_ids
string[]
required

A list of media IDs to be used for the post. The order of the media in the published post depends on the order in this field

​
first_comments
FirstComments · object
required
​
publication_date
string<date-time> | null
required

The publication date for this post in UTC timezone

Example:

"2026-06-14T09:00:00.000Z"

​
publication_timestamp
integer | null
required

UNIX timestamp format of publication_date

Example:

1781427600000

​
customized_publication_date
string[] | null
required
​
publication_delay_between
integer
required

Delay in minutes between posts during publishing.

Example:

  • 3 social accounts selected
  • publication_delay_between = 10

The first post will be published at 9:00, the second at 9:10, and the third at 9:20

​
fb_post_type
enum<integer> | null
required

1 Feed
2 Reel
3 Story
4 Carousel
5 PageCover

Available options:
1,
2,
3,
4,
5
​
fb_video_title
string | null
required
​
ig_post_type
enum<integer> | null
required

1 Feed
2 Reel
3 Story

Available options:
1,
2,
3
​
ig_collaborators
string[]
required
​
ig_share_to_feed
boolean
required
​
ig_allow_comments
boolean
required
​
ig_audio_name
string | null
required
​
li_post_type
enum<integer> | null
required

1 Normal
2 Poll
3 Carousel

Available options:
1,
2,
3
​
li_carousel_title
string | null
required
​
li_poll
LinkedInPoll · object
required
​
tt_post_type
enum<integer> | null
required

1 Video
2 ImageCarousel

Available options:
1,
2
​
tt_privacy_level
enum<integer> | null
required

1 PublicToEveryone
2 MutualFollowFriends
3 SelfOnly
4 FollowerOfCreator

Available options:
1,
2,
3,
4
​
tt_carousel_title
string | null
required
​
tt_disable_duet
boolean
required
​
tt_disable_stitch
boolean
required
​
tt_disable_comment
boolean
required
​
tt_brand_content
boolean
required
​
tt_brand_organic
boolean
required
​
tt_auto_music
boolean
required
​
tt_is_aigc
boolean
required
​
pi_pin_title
string | null
required
​
pi_url_link
string | null
required
​
pi_boards
string[] | null
required
​
pi_sections
string[] | null
required
​
pi_is_standard_pin
boolean
required
​
gb_post_type
enum<integer> | null
required

1 Standard
2 Event
3 Offer

Available options:
1,
2,
3
​
gb_event_title
string | null
required
​
gb_start_date
string<date-time> | null
required
​
gb_end_date
string<date-time> | null
required
​
gb_use_time
boolean
required
​
gb_action_type
enum<integer> | null
required

1 Book
2 Order
3 Shop
4 LearnMore
5 SignUp
6 Call

Available options:
1,
2,
3,
4,
5,
6
​
gb_action_url
string | null
required
​
gb_coupon_code
string | null
required
​
gb_redeem_url
string | null
required
​
gb_term_conditions
string | null
required
​
yt_post_type
enum<integer> | null
required

1 Video
2 Shorts

Available options:
1,
2
​
yt_video_title
string | null
required
​
yt_video_tags
string[]
required
​
yt_categories
string[] | null
required
​
yt_playlists
string[] | null
required
​
yt_privacy_level
enum<integer> | null
required

1 Public
2 Private
3 Unlisted

Available options:
1,
2,
3
​
yt_license
enum<integer> | null
required

1 StandardYouTubeLicense
2 CreativeCommons

Available options:
1,
2
​
yt_embeddable
boolean
required
​
yt_notify_subscribers
boolean
required
​
yt_made_for_kids
boolean
required
​
dr_title
string | null
required
​
dr_tags
string[]
required
​
tw_post_type
enum<integer> | null
required

1 Normal
2 Poll

Available options:
1,
2
​
tw_poll
string[] | null
required
​
tw_reply_settings
enum<integer> | null
required

1 Following
2 MentionedUsers
3 Subscribers
4 Verified

Available options:
1,
2,
3,
4
​
th_post_type
enum<integer> | null
required

1 Normal
2 Poll

Available options:
1,
2
​
th_poll
string[] | null
required
​
th_topic_tag
string | null
required
​
customized
object
required

Per-network content customization, keyed by social network identifier

​
is_publicly_shared
boolean
required
​
guest_approver_name
string | null
required
​
everyone_must_approve
boolean
required

If multiple assignees are selected, this determines whether all of them must approve or if just one approval is needed.

Only for Strict approval workflows

​
should_skip
boolean
required

If true, post will not be published. The post will change its status to Skipped

​
approved_at
string<date-time> | null
required
​
published_at
string<date-time> | null
required
​
created_at
string<date-time> | null
required
​
updated_at
string<date-time> | null
required
​
user
UserData · object
required

Relationships data on request. Depends on the endpoint and the include parameter

​
socialAccounts
SocialAccountData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
comments
PostCommentData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
tasks
PostTaskData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
details
PostDetailData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
media
MediaData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
labels
LabelData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
approvals
PostApprovalData · object[]
required

Relationships data on request. Depends on the endpoint and the include parameter

​
selectedAccountIds
string[]
required

The IDs of the social media accounts selected where the post will be published

​
assigneesIds
string[]
required

IDs of users selected as assignees

​
source
enum<integer> | null
required

Describes how the post was created

1 Web
2 Api
3 Mcp
4 ClickUp
5 CsvImport

Available options:
1,
2,
3,
4,
5
​
cu_creator_name
string | null
required

Creator name of the post in Clickup. Will only be available if the post was created in ClickUp