Analytics

View platform and post-level analytics from the command line

Platform Analytics

Get analytics for a specific integration/channel. Returns metrics like followers, impressions, and engagement over time.

sipstory analytics:platform <integration-id>

Options

Flag	Description
-d, --date	Number of days to look back (default: 7)

Examples

# Last 7 days (default)
sipstory analytics:platform your-integration-id

# Last 30 days
sipstory analytics:platform your-integration-id -d 30

# Last 90 days
sipstory analytics:platform your-integration-id -d 90

The response is an array of metrics, each with daily data points:

[
  {
    "label": "Followers",
    "data": [
      { "total": "1250", "date": "2025-01-01" },
      { "total": "1280", "date": "2025-01-02" }
    ],
    "percentageChange": 2.4
  },
  {
    "label": "Impressions",
    "data": [
      { "total": "5000", "date": "2025-01-01" },
      { "total": "5200", "date": "2025-01-02" }
    ],
    "percentageChange": 4.0
  }
]

note

The metrics returned depend on the platform. For example, X returns followers and impressions, while YouTube may return subscribers and views.

Post Analytics

Get analytics for a specific published post. Returns metrics like likes, comments, shares, and impressions.

sipstory analytics:post <post-id>

Options

Flag	Description
-d, --date	Number of days to look back (default: 7)

Examples

# Last 7 days (default)
sipstory analytics:post your-post-id

# Last 30 days
sipstory analytics:post your-post-id -d 30

The response follows the same format as platform analytics:

[
  {
    "label": "Likes",
    "data": [
      { "total": "150", "date": "2025-01-01" },
      { "total": "175", "date": "2025-01-02" }
    ],
    "percentageChange": 16.7
  },
  {
    "label": "Comments",
    "data": [
      { "total": "25", "date": "2025-01-01" },
      { "total": "30", "date": "2025-01-02" }
    ],
    "percentageChange": 20.0
  }
]

tip

Post analytics are only available for published posts. Draft or queued posts won't return analytics data.

Scripting with Analytics

Extract specific metrics using jq:

# Get just the follower count trend
sipstory analytics:platform integration-id -d 30 | jq '.[] | select(.label=="Followers")'

# Get percentage changes for all metrics
sipstory analytics:platform integration-id | jq '.[] | {label, percentageChange}'

# Get the latest total for each post metric
sipstory analytics:post post-id | jq '.[] | {label, latest: .data[-1].total}'