rizamodocs
Posts

List posts

GET
/posts

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the web app, under Developers. It starts with rz_live_.

Query Parameters

status?string

partially_published: some targets went out and others failed; each target has its own status.

Value in"draft""scheduled""published""partially_published""failed"
profileId?string
accountId?string

Posts with a target on this account.

from?string
Formatdate-time
to?string
Formatdate-time
q?string
fields?

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?string

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

Default"exclude"
Value in"exclude""include""only"
limit?integer
Range1 <= value <= 200
Default100

Response Body

OK

application/json
  1. response
items*array<>
Example Request
curl -X GET 'https://api.rizamo.com/v1/posts'
Example Response200
{  "items": [    {      "id": "string",      "profileId": "string",      "status": "draft",      "text": "string",      "media": [        {          "id": "string",          "type": "image",          "url": "string",          "alt": "string"        }      ],      "targets": [        {          "accountId": "string",          "network": "instagram",          "format": "feed",          "text": "string",          "media": [            {              "id": "string",              "type": "image",              "url": "string",              "alt": "string"            }          ],          "options": {            "instagram": {              "shareToFeed": true,              "coverUrl": "http://example.com",              "collaborators": [                "string"              ],              "locationId": "string"            },            "facebook": {              "link": "http://example.com"            },            "tiktok": {              "disableComments": true,              "disableDuet": true,              "disableStitch": true,              "isBrandedContent": true,              "isYourBrand": true,              "isAiGenerated": true            },            "linkedin": {              "documentTitle": "string"            },            "youtube": {              "title": "string",              "privacy": "public",              "madeForKids": true,              "tags": [                "string"              ]            },            "pinterest": {              "boardId": "string",              "title": "string",              "link": "http://example.com"            }          },          "firstComment": "string",          "status": "pending",          "url": "string",          "error": "string",          "removal": "removed"        }      ],      "scheduledAt": "2019-08-24T14:15:22Z",      "publishedAt": "2019-08-24T14:15:22Z",      "createdBy": {        "type": "agent",        "agent": "claude",        "name": "string"      },      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "fields": {        "property1": "string",        "property2": "string"      },      "metrics": {        "impressions": -9007199254740991,        "reach": -9007199254740991,        "engagements": -9007199254740991,        "likes": -9007199254740991,        "comments": -9007199254740991,        "shares": -9007199254740991,        "saves": -9007199254740991,        "clicks": -9007199254740991      },      "deletedAt": "2019-08-24T14:15:22Z"    }  ]}