List publishing posts

List scheduled posts, drafts or posts waiting for approval.

GET https://cotlet.dev/api/v1/sprout-social/publishing-posts

read

Returns posts from the Publishing section with their profiles, text, scheduled time and status. status picks the tab: scheduled for the Publishing Calendar, draft for Drafts, needs_approval for Needs Approval. Posts submitted for approval do not appear in scheduled. Results are paged.

Parameters

Parameters: list_publishing_posts
NameTypeDescription
status string string scheduled (default), draft or needs_approval.
profile_ids string[] string[] Profile IDs from list_profiles. Leave empty for every profile your login can see.
since string string Only posts scheduled after this ISO date-time.
until string string Only posts scheduled before this ISO date-time.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/sprout-social/publishing-posts \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("sprout-social", "list_publishing_posts")
Node.js
const result = await cotlet.call('sprout-social', 'list_publishing_posts');
CLI
cotlet call sprout-social list_publishing_posts

Example response

JSON

{
  "posts": [
    {
      "post_id": "pub_3301",
      "profile_id": "p_li_02",
      "network": "linkedin",
      "text": "Our autumn release is live.",
      "scheduled_at": "2026-10-21T09:00:00+02:00",
      "status": "needs_approval",
      "approval_workflow": "Brand review"
    },
    {
      "post_id": "pub_3302",
      "profile_id": "p_ig_01",
      "network": "instagram",
      "text": "Behind the scenes at the studio.",
      "scheduled_at": "2026-10-22T10:00:00+02:00",
      "status": "scheduled",
      "approval_workflow": null
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.