Zilfu
API ReferenceAnalytics

List an account's posts with their metrics

Every post the account published in the range, paginated, one row per post, with a column for each metric the platform declares. Order it by sortpublished_at, interactions or any declared metric key — and dir; a key this account does not declare is a 422 naming the ones it does. Defaults to the last 7 days in the space timezone, newest first, 20 per page.

GET
/spaces/{space}/accounts/{account}/analytics/posts
AuthorizationBearer <token>

In: header

Path Parameters

space*integer

The space ID

account*integer

The account ID

Query Parameters

from?string
Formatdate-time
to?string
Formatdate-time
sort?string
dir?string
Value in"asc" | "desc"
per_page?integer
Range10 <= value <= 100
page?integer
Range1 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://zilfu.app/api/spaces/0/accounts/0/analytics/posts"
{
  "contract": "string",
  "account": {
    "id": 0,
    "social": "string",
    "display_name": "string",
    "handler": "string",
    "avatar": "string",
    "disconnected_at": "string"
  },
  "range": {
    "from": "string",
    "to": "string",
    "timezone": "string",
    "days": 0,
    "previous_from": "string",
    "previous_to": "string"
  },
  "collection": {
    "state": "string",
    "reason": "string",
    "remedy": "string",
    "last_collected_at": "string",
    "cadence_hours": 0,
    "polling_window_days": 0
  },
  "sort": {
    "key": "string",
    "direction": "string",
    "options": [
      {
        "key": "string",
        "label": "string",
        "sortable": true,
        "reason": "string"
      }
    ]
  },
  "columns": [
    {
      "key": "string",
      "label": "string",
      "definition": "string",
      "unit": "string",
      "headline": true,
      "status": "string",
      "reason": "string"
    }
  ],
  "data": [
    {
      "post_id": 0,
      "published_at": "string",
      "permalink": "string",
      "imported": true,
      "excerpt": "string",
      "thumbnail": "string",
      "metrics": {
        "property1": {
          "value": 0,
          "status": "string",
          "reason": "string"
        },
        "property2": {
          "value": 0,
          "status": "string",
          "reason": "string"
        }
      },
      "interactions": {
        "total": 0,
        "source": "string",
        "components": {
          "property1": 0,
          "property2": 0
        },
        "status": "string",
        "reason": "string"
      }
    }
  ],
  "meta": {
    "current_page": 0,
    "last_page": 0,
    "per_page": 0,
    "total": 0
  }
}
{
  "message": "string"
}
{
  "message": "string"
}
{
  "message": "string"
}
{
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}