Skip to main content
GET
/
social-account-posts
List social account posts
curl --request GET \
  --url https://api.woopsocial.com/v1/social-account-posts \
  --header 'Authorization: Bearer <token>'
{
  "socialAccountPosts": [
    {
      "platform": "PINTEREST",
      "socialAccountPostId": "<string>",
      "postId": "<string>",
      "projectId": "<string>",
      "socialAccountId": "<string>",
      "deliveryStatus": "NOT_STARTED",
      "content": [
        {
          "text": "<string>",
          "media": [
            {
              "type": "MEDIA_LIBRARY",
              "mediaId": "<string>",
              "mediaType": "IMAGE",
              "url": "<string>",
              "thumbnailUrl": "<string>"
            }
          ]
        }
      ],
      "schedule": {
        "type": "DRAFT"
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "pinterestBoardId": "<string>",
      "deliveryCompletedAt": "2023-11-07T05:31:56Z",
      "externalPostId": "<string>",
      "externalPostUrl": "<string>",
      "errorMessage": "<string>",
      "title": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization
string
header
required

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

Query Parameters

projectId
string[]

Filter to one or more projects. Provide a comma-separated list of project IDs.

socialAccountId
string[]

Filter to one or more connected social accounts. Provide a comma-separated list of social account IDs.

postId
string[]

Filter to one or more parent posts. Provide a comma-separated list of post IDs.

platform
enum<string>[]

Filter to one or more social platforms. Provide a comma-separated list of platform values.

Identifies which social media platform this data structure targets.

Available options:
PINTEREST,
LINKEDIN,
LINKEDIN_PAGES,
INSTAGRAM,
FACEBOOK,
TIKTOK,
X,
YOUTUBE,
WOOPTEST
deliveryStatus
enum<string>[]

Filter to one or more delivery statuses. Provide a comma-separated list of delivery status values.

Delivery lifecycle status for a post.

NOT_STARTED: The post exists and is scheduled, but delivery has not started yet. SENDING: Delivery is currently in progress. PUBLISHED: Delivery completed successfully. FAILED: Delivery completed unsuccessfully.

Available options:
NOT_STARTED,
SENDING,
PUBLISHED,
FAILED
limit
integer<int32>
default:50

Number of items to return.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor for the next page of results.

Response

200 - application/json

Social account posts.

socialAccountPosts
(Pinterest · object | Instagram · object | Facebook · object | TikTok · object | YouTube · object | X · object | LinkedIn · object | LinkedIn Pages · object | WoopTest · object)[]
required
nextCursor
string

Opaque cursor for the next page of results. Omitted when there are no more results.