Posts

List posts

The team's posts, ordered by when they go out: their scheduledAt, or when they were created if they have none. The latest first, or the earliest first with order asc. A page at a time: pass nextCursor as cursor for the next one, with the same filters and order.

get/posts

Request

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

Query parameters

status'draft' | 'scheduled' | 'published' | 'partially_published' | 'failed'

Only posts with this status.

profileIdstring

Only this profile's (prof_): one brand or client, from List profiles. A profile you do not reach is refused as not found.

accountIdstring

Posts with a target on this account (acc_).

fromstring date-time

Posts whose time is this or later. A post's time is its scheduledAt (when it goes or went out; publishing now sets it), or its createdAt when it has none, such as a draft with no date. Inclusive.

tostring date-time

Posts whose time, as for from, is this or earlier. Inclusive.

qstring

Posts whose text has this, in any case.

fieldsobject

Only posts whose custom fields have these values, for example fields[campaign]=Winter menu. A multi_select field matches when it has the value.

deleted'exclude' | 'include' | 'only'

Deleted posts are left out unless asked: only lists the ones that can still be restored.

order'desc' | 'asc'

desc, the latest first, or asc, the earliest first: with from and to, asc reads a period forward.

cursorstring

nextCursor from the page before, with the same filters and order.

limitinteger

How many to return, up to 200: 100 when left out.

Response

OK

nextCursorstring nullable required

Null on the last page.

Changes

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