Get posts by IDs

curl --request GET \
  --url https://api.postflow.app/v1/posts-bulk \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.postflow.app/v1/posts-bulk"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.postflow.app/v1/posts-bulk', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.postflow.app/v1/posts-bulk",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.postflow.app/v1/posts-bulk"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.postflow.app/v1/posts-bulk")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.postflow.app/v1/posts-bulk")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "public_id": "<string>",
    "organization_id": "<string>",
    "user_id": "<string>",
    "post_id": "<string>",
    "cu_task_id": "<string>",
    "name": "<string>",
    "note": "<string>",
    "visible_for_client": true,
    "content": "<string>",
    "content_weighted_length": 123,
    "has_customized_content": true,
    "locations": [
      {
        "id": "<string>",
        "name": "<string>",
        "location": [
          "<string>"
        ],
        "followers_count": 123,
        "username": "<string>"
      }
    ],
    "image_tags": [
      {
        "id": "<string>",
        "media_id": "<string>",
        "x": 123,
        "y": 123,
        "mode": "user",
        "username": "<string>",
        "social_account_id": "<string>",
        "product": [
          "<string>"
        ]
      }
    ],
    "selected_media_ids": [
      "<string>"
    ],
    "first_comments": {
      "enabled": true,
      "socialAccountIds": [
        "<string>"
      ],
      "conditionValue": 123,
      "content": "<string>",
      "customized": {
        "linkedin": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "instagram": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "facebook": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "youtube": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "threads": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "bluesky": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "twitter": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        }
      }
    },
    "publication_date": "2023-11-07T05:31:56Z",
    "publication_timestamp": 123,
    "customized_publication_date": [
      "<string>"
    ],
    "publication_delay_between": 123,
    "fb_video_title": "<string>",
    "ig_collaborators": [
      "<string>"
    ],
    "ig_share_to_feed": true,
    "ig_allow_comments": true,
    "ig_audio_name": "<string>",
    "li_carousel_title": "<string>",
    "li_poll": {
      "question": "<string>",
      "option_1": "<string>",
      "option_2": "<string>",
      "option_3": "<string>",
      "option_4": "<string>"
    },
    "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_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_url": "<string>",
    "gb_coupon_code": "<string>",
    "gb_redeem_url": "<string>",
    "gb_term_conditions": "<string>",
    "yt_video_title": "<string>",
    "yt_video_tags": [
      "<string>"
    ],
    "yt_categories": [
      "<string>"
    ],
    "yt_playlists": [
      "<string>"
    ],
    "yt_embeddable": true,
    "yt_notify_subscribers": true,
    "yt_made_for_kids": true,
    "dr_title": "<string>",
    "dr_tags": [
      "<string>"
    ],
    "tw_poll": [
      "<string>"
    ],
    "th_poll": [
      "<string>"
    ],
    "th_topic_tag": "<string>",
    "customized": {
      "twitter": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "linkedin": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "facebook": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "instagram": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "tiktok": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "bluesky": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "pinterest": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "google_business_profile": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "youtube": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "threads": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "snapchat": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "dribbble": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "tumblr": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      }
    },
    "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>",
      "is_client": true,
      "can_approve": true,
      "can_connect_account": true,
      "can_access_all_groups": true,
      "self_approval": true,
      "time_format_24": true,
      "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": [],
    "cu_creator_name": "<string>"
  }
]

{
  "message": "<string>"
}

{
  "message": "<string>",
  "errors": {}
}

GET

posts-bulk

Get posts by IDs

curl --request GET \
  --url https://api.postflow.app/v1/posts-bulk \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.postflow.app/v1/posts-bulk"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.postflow.app/v1/posts-bulk', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.postflow.app/v1/posts-bulk",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.postflow.app/v1/posts-bulk"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.postflow.app/v1/posts-bulk")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.postflow.app/v1/posts-bulk")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "<string>",
    "public_id": "<string>",
    "organization_id": "<string>",
    "user_id": "<string>",
    "post_id": "<string>",
    "cu_task_id": "<string>",
    "name": "<string>",
    "note": "<string>",
    "visible_for_client": true,
    "content": "<string>",
    "content_weighted_length": 123,
    "has_customized_content": true,
    "locations": [
      {
        "id": "<string>",
        "name": "<string>",
        "location": [
          "<string>"
        ],
        "followers_count": 123,
        "username": "<string>"
      }
    ],
    "image_tags": [
      {
        "id": "<string>",
        "media_id": "<string>",
        "x": 123,
        "y": 123,
        "mode": "user",
        "username": "<string>",
        "social_account_id": "<string>",
        "product": [
          "<string>"
        ]
      }
    ],
    "selected_media_ids": [
      "<string>"
    ],
    "first_comments": {
      "enabled": true,
      "socialAccountIds": [
        "<string>"
      ],
      "conditionValue": 123,
      "content": "<string>",
      "customized": {
        "linkedin": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "instagram": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "facebook": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "youtube": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "threads": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "bluesky": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        },
        "twitter": {
          "enabled": true,
          "socialAccountIds": [
            "<string>"
          ],
          "conditionValue": 123,
          "content": "<string>"
        }
      }
    },
    "publication_date": "2023-11-07T05:31:56Z",
    "publication_timestamp": 123,
    "customized_publication_date": [
      "<string>"
    ],
    "publication_delay_between": 123,
    "fb_video_title": "<string>",
    "ig_collaborators": [
      "<string>"
    ],
    "ig_share_to_feed": true,
    "ig_allow_comments": true,
    "ig_audio_name": "<string>",
    "li_carousel_title": "<string>",
    "li_poll": {
      "question": "<string>",
      "option_1": "<string>",
      "option_2": "<string>",
      "option_3": "<string>",
      "option_4": "<string>"
    },
    "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_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_url": "<string>",
    "gb_coupon_code": "<string>",
    "gb_redeem_url": "<string>",
    "gb_term_conditions": "<string>",
    "yt_video_title": "<string>",
    "yt_video_tags": [
      "<string>"
    ],
    "yt_categories": [
      "<string>"
    ],
    "yt_playlists": [
      "<string>"
    ],
    "yt_embeddable": true,
    "yt_notify_subscribers": true,
    "yt_made_for_kids": true,
    "dr_title": "<string>",
    "dr_tags": [
      "<string>"
    ],
    "tw_poll": [
      "<string>"
    ],
    "th_poll": [
      "<string>"
    ],
    "th_topic_tag": "<string>",
    "customized": {
      "twitter": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "linkedin": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "facebook": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "instagram": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "tiktok": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "bluesky": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "pinterest": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "google_business_profile": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "youtube": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "threads": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "snapchat": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "dribbble": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      },
      "tumblr": {
        "content": "<string>",
        "content_json": "<string>",
        "media_ids": [
          "<string>"
        ]
      }
    },
    "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>",
      "is_client": true,
      "can_approve": true,
      "can_connect_account": true,
      "can_access_all_groups": true,
      "self_approval": true,
      "time_format_24": true,
      "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": [],
    "cu_creator_name": "<string>"
  }
]

{
  "message": "<string>"
}

{
  "message": "<string>",
  "errors": {}
}

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

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

Show child attributes

image_tags

MediaTagData · object[]

required

Show child attributes

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 | null

required

Show child attributes

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_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 | null

required

Show child attributes

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 | null

required

Per-network content customization, keyed by social network identifier

Show child attributes

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 | null

required