Skip to main content
PostVersion: 2021-04-15

Get posts

POST/social-media-posting/{locationId}/posts/list

Get Posts

Authorizations

Authorizationstringheaderrequired

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

Scope:socialplanner/post.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available options2021-04-15
Example:2021-07-28

Path Parameters

locationIdstringrequired

Location ID (also known as Sub-Account ID) for the business location.

Example:ve9EPM428h8vShlRW1KT

Body

typestring

type must be one of the following values: recent, all, scheduled, draft, failed, in_review, published, in_progress, pending and deleted

Default:all
Example:all
accountsstring

List of account Ids separated by comma as a string

Example:660a83fc29deacac50033e2b_omaDY3RbWtTP511e808O_17841465964543589, 38bF83fc29deacac50033e2b_omaDY3RbWtr3P11e808O_17841465964543998
skipstring

Number of records to skip for pagination. Send as a numeric string — a JSON number is rejected.

Default:0
Example:0
limitstring

Maximum number of records to return. Send as a numeric string — a JSON number is rejected.

Default:10
Example:10
fromDatestring

From Date

Example:2024-01-22T05:32:49.463Z
toDatestring

To Date

Example:2024-03-20T05:32:49.463Z
includeUsersstring

Include User Data

Example:true
postTypestring

Post Type must be one of the following values: post, story, reel, short

Matches the top-level type a post was created with (see the type field on Create Post), so only these three values can ever match a post.

Available optionspoststoryreel
Example:post

Response

Successful response

successbooleanrequired

Success or Failure

Example:true
statusCodenumberrequired

Status Code

Example:201
messagestringrequired

Message

Example:Fetched Posts
resultsobject

Requested Results