Posts

List posts

Returns a paginated list of posts filtered by their status. Use the type parameter to fetch scheduled, draft, awaiting-approval, or published posts. Reviewed post objects include reviewed_by with id, name, and action (approved or rejected) when approval metadata is available.

get/posts

Request

  • Base URL: https://socialbu.com/api/v1
  • URL: https://socialbu.com/api/v1/posts
  • Auth: HTTP bearer

Query parameters

type'scheduled' | 'awaiting_approval' | 'scheduled_or_awaiting_approval' | 'draft' | 'published'

The type of posts you want to fetch

perPageinteger

Number of posts per page. Maximum 100.

pageinteger

Page number to fetch.

startstring date

Filter posts on or after this date.

endstring date

Filter posts on or before this date.

teaminteger

Limit results to a specific team ID.

accountsinteger[]

Limit results to specific account IDs.

userinteger

Limit results to posts created by a specific user ID.

tagsinteger[]

Limit results to posts having any of these tag IDs. Send either a comma-separated list (tags=1,2) or the repeated tags[]=1&tags[]=2 form.

sourcestring

Filter by post source.

qstring

Free-text search query.

include_postinteger

Include a specific post ID in the result set when relevant to the UI flow.

Response

Get Posts

itemsobject[]

An array of post objects.

currentPageinteger

The current page number of the paginated results.

lastPageinteger

The last page number of the paginated results.

nextPageinteger nullable

The next page number, or null if this is the last page.

totalinteger

Total number of items.

Changes

No recorded changes to this operation across all 1 revision of this API.