Analytics

List channel post performance

Ranks the channel's posts of the range (made in TryPost or not) by one metric, best first, and returns the top 50 a page at a time. Page size is set by the server: read meta.per_page. The response also carries the filters the server applied. Posts without the metric come last. Same time zone, filters, range clamping and 404 rule as GET /channels/{account}/insights.

get/channels/{account}/insights/publications

Request

  • Base URL: https://app.trypost.it/api
  • URL: https://app.trypost.it/api/channels/{account}/insights/publications
  • 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'

previous ranks the posts of the previous range of the same length.

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

Metric to rank by. When the channel does not report it (or it is omitted), the first of these the channel reports is used; filters.sort says which.

pageinteger

Response

A page of ranked posts.

Changes

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