Analytics

List post analytics

Per-post analytics snapshots, cursor-paginated. metrics.* fields use null (not 0) to mean "unknown" or "the platform's insights scope wasn't granted on this connection". Treat them differently in aggregations you display.

The cursor is bound to the current sort key; don't switch sort mid-pagination.

get/analytics/posts

Request

  • Base URL: https://api.shortsync.app/v1
  • URL: https://api.shortsync.app/v1/analytics/posts
  • Auth: HTTP bearer

Query parameters

platformstring

Comma-separated platform filter.

connection_idstring

Narrow to one connection.

published_afterstring date-time

ISO 8601 lower bound on the post's published_at.

published_beforestring date-time

ISO 8601 upper bound.

sort'fetched_at_desc' | 'published_at_desc' | 'views_desc'

Sort key. fetched_at_desc (default), published_at_desc, or views_desc.

cursorstring

Opaque cursor returned by a previous list response. Omit on the first page.

limitinteger

Maximum items to return (1-100). Default 25.

Response

Page of analytics rows.

Changes

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