Analytics

Get channel insights

Returns the insights of one channel for a date range: the metrics it reports, the summary and the metric series for the range and the previous range. Days are calendar days in the API key user's time zone. Labels, untagged and types narrow the post metrics; followers stay account-wide. Channels on LinkedIn, LinkedIn pages, Telegram, Discord and Google Business have no insights and return 404. With custom (or start/end without range), the dates are clamped to the days with data in scope (bounds; for a channel, that channel's). When there is no data yet, the dates are ignored and the last 30 days are returned. A missing end defaults to the last day with data, and a missing start to 29 days before end. Read range (or filters.start/filters.end) in the response for the days actually used.

get/channels/{account}/insights

Request

  • Base URL: https://app.trypost.it/api
  • URL: https://app.trypost.it/api/channels/{account}/insights
  • Auth: HTTP bearer

Query parameters

range'7d' | '30d' | 'mtd' | 'custom'

7d (last 7 days), 30d (last 30 days, the default), mtd (month to date) or custom. Days are calendar days in the API key user's time zone, today included.

startstring date

First day, Y-m-d. Required with range=custom and ignored for the other presets. Sending start and end without range means custom.

endstring date

Last day, Y-m-d, on or after start. Required with range=custom.

labels[]string[]

Only posts with any of these labels (labels of this workspace). Unknown or deleted labels return 422.

untagged'1' | '0'

Also (or only) posts without labels. Posts made outside TryPost have no labels. Send 1 or 0; true and false are rejected with 422.

types[]ContentType[]

Only these content types. They must belong to the channel's network.

period'current' | 'previous'

Accepted for parity with the post list; only echoed in filters here.

sort'reactions' | 'comments' | 'engagement_rate' | 'views' | 'impressions' | 'shares' | 'saves' | 'reach'

Accepted for parity with the post list; only echoed in filters here.

Response

The channel's insights.

available_metricsstring[]

Metrics this channel reports, in display order (followers, net_followers, posts, reactions, comments, engagement_rate, views, impressions, shares, reposts, quotes, saves, clicks, follows_gained, reach, watch_time_minutes, average_watch_time_seconds).

Example response

{
  "metric_series": {
    "growth": {
      "months": [
        {
          "month": "2026-10"
        }
      ]
    }
  }
}

Changes

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