Query
engagementHistory
Paginated history of engagement metric snapshots for a specific item, ordered newest first.
Arguments
Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.
- after String default null
- Cursor for fetching the next page of results.
- filter EngagementHistoryFilterInput default null
- Filter criteria for engagement history entries.
- capturedAt FilterDateRangeInput
- Filter by the date range when engagement metrics were captured.
- from DateTime
- Inclusive lower bound (ISO 8601). Omit for no lower bound.
- to DateTime
- Inclusive upper bound (ISO 8601). Omit for no upper bound.
- first Int default 20
- Number of entries to return (page size).
- itemId ID! required
- The ID of the item to fetch engagement history for.
Returns
A paginated connection of EngagementHistoryEntry nodes. See Pagination for the connection shape.
- edges [EngagementHistoryEntryEdge!]!
- List of edges with cursors.
- cursor String!
- Cursor for this node.
- node EngagementHistoryEntry!
- The engagement history entry.
- at DateTime!
- Timestamp when the engagement metrics were captured (UTC).
- comments BigInt
- Total number of comments.
- earnedMediaValue BigInt
- Estimated earned media value (EMV) in cents.
- followers BigInt
- Number of followers at the time of capture.
- impressions BigInt
- Number of views, plays, or estimated impressions.
- likes BigInt
- Total number of likes.
- linearViralityScore ViralityScore!
- Bucketed virality score based on engagement relative to follower count.
- HIGH
- Content that significantly outperforms its expected reach. Typically corresponds to a view-to-follower ratio of 4.0 or higher.
- LOW
- Content performing close to expected baseline relative to audience size. Typically corresponds to a view-to-follower ratio between ~1.0 and 2.0.
- MEDIUM
- Content performing above average relative to audience size. Typically corresponds to a view-to-follower ratio between ~2.0 and 4.0.
- NOT_VIRAL
- Content performing below expected reach, with low relative visibility. Typically corresponds to a view-to-follower ratio below ~1.0.
- shares BigInt
- Number of shares.
- views BigInt
- Number of views.
- nodes [EngagementHistoryEntry!]!
- List of engagement history entries.
- at DateTime!
- Timestamp when the engagement metrics were captured (UTC).
- comments BigInt
- Total number of comments.
- earnedMediaValue BigInt
- Estimated earned media value (EMV) in cents.
- followers BigInt
- Number of followers at the time of capture.
- impressions BigInt
- Number of views, plays, or estimated impressions.
- likes BigInt
- Total number of likes.
- linearViralityScore ViralityScore!
- Bucketed virality score based on engagement relative to follower count.
- HIGH
- Content that significantly outperforms its expected reach. Typically corresponds to a view-to-follower ratio of 4.0 or higher.
- LOW
- Content performing close to expected baseline relative to audience size. Typically corresponds to a view-to-follower ratio between ~1.0 and 2.0.
- MEDIUM
- Content performing above average relative to audience size. Typically corresponds to a view-to-follower ratio between ~2.0 and 4.0.
- NOT_VIRAL
- Content performing below expected reach, with low relative visibility. Typically corresponds to a view-to-follower ratio below ~1.0.
- shares BigInt
- Number of shares.
- views BigInt
- Number of views.
- pageInfo PageInfo!
- Pagination information.
- endCursor String
- Cursor for the last node in this page.
- hasNextPage Boolean!
- Whether there are more results after this page.
- hasPreviousPage Boolean!
- Whether there are results before this page.
- startCursor String
- Cursor for the first node in this page.
- totalCount Int
- Total number of items available.