Performance

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/antwork-io/json-schema/antwork-io-performance-schema.json",
  "title": "Performance",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/antwork-io-openapi.json#/components/schemas/Performance",
  "type": "object",
  "required": [
    "object",
    "workspaceId",
    "window",
    "platforms",
    "rows",
    "rowCount"
  ],
  "properties": {
    "object": {
      "const": "performance"
    },
    "workspaceId": {
      "type": "string"
    },
    "window": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      }
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "type": "string"
          },
          "postCount": {
            "type": "integer"
          },
          "totals": {
            "type": "object",
            "additionalProperties": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "engagement": {
            "type": [
              "number",
              "null"
            ]
          },
          "rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "skipped": {
            "type": "integer"
          },
          "syncedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "oldestAsOf": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "postId": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "publishedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "accountId": {
            "type": "string"
          },
          "campaignId": {
            "type": "string"
          },
          "goal": {
            "type": "string",
            "description": "The post's goal, when it has one."
          },
          "metrics": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/$defs/MetricCell"
            }
          },
          "engagement": {
            "type": [
              "number",
              "null"
            ]
          },
          "rate": {
            "type": [
              "number",
              "null"
            ]
          },
          "degraded": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "rowCount": {
      "type": "integer"
    },
    "degradedRows": {
      "type": "integer"
    },
    "previous": {
      "type": "array",
      "description": "With `compare`: the platform totals over the preceding window."
    },
    "findings": {
      "$ref": "#/$defs/PerformanceFindings"
    }
  },
  "$defs": {
    "MetricCell": {
      "type": "object",
      "required": [
        "value",
        "state"
      ],
      "properties": {
        "value": {
          "type": [
            "number",
            "null"
          ],
          "description": "Null unless `state` is `measured`; never 0 for unknown."
        },
        "state": {
          "type": "string",
          "description": "`measured`, `unsupported` (the platform cannot supply it), `unreadable` (a carried-forward value), or not yet measured."
        },
        "basis": {
          "type": "string"
        },
        "reason": {
          "type": "string"
        },
        "asOf": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "PerformanceFindings": {
      "type": "object",
      "description": "With `findings`: what the window says, each a comparison of numbers in the report, with a floor below which it says there is not enough data. The same block MCP get_performance returns.",
      "properties": {
        "timezone": {
          "type": "string",
          "description": "The workspace timezone the weekdays and hours are in."
        },
        "comparison": {
          "type": "object",
          "description": "Per platform, this window against the preceding one of equal length. Reach is compared only when both windows count the same thing (`basis`).",
          "properties": {
            "previousFrom": {
              "type": [
                "string",
                "null"
              ]
            },
            "previousTo": {
              "type": [
                "string",
                "null"
              ]
            },
            "platforms": {
              "type": "array",
              "items": {
                "type": "object"
              }
            }
          }
        },
        "ranking": {
          "type": "object",
          "description": "The top and bottom three posts by engagement rate, and the traits most of the top ones share and fewer bottom ones do; `enoughData: false` under six rated posts."
        },
        "bestWindows": {
          "type": "array",
          "items": {
            "type": "object"
          },
          "description": "Per account: windows from its own posts, or labelled fallbacks when it has too few."
        },
        "followers": {
          "type": "array",
          "items": {
            "type": "object"
          },
          "description": "Per account: first and last measured follower count in the window."
        },
        "postAgainToday": {
          "type": "array",
          "items": {
            "type": "object"
          },
          "description": "Per account: posts in the last 24 hours, scheduled in the next 24, the usual count on posting days, and the daily cap."
        }
      }
    }
  }
}