Query
engagementHistory
Paginate engagement metric snapshots for one item, 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, default 20, max 1000). One page can hold an item's full snapshot history.
- 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. Use this field for a post's views, plays, or reach. Archive estimates it for Instagram stories. For other posts it holds the larger of the platform's view and play counts. Archive estimates it for an Instagram post that has neither count. Null when Archive has no count for the post.
- 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
- View count as reported by the platform, kept separate from plays. Rarely populated: null for most items. Use
impressionsfor views, plays, or reach. - 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. Use this field for a post's views, plays, or reach. Archive estimates it for Instagram stories. For other posts it holds the larger of the platform's view and play counts. Archive estimates it for an Instagram post that has neither count. Null when Archive has no count for the post.
- 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
- View count as reported by the platform, kept separate from plays. Rarely populated: null for most items. Use
impressionsfor views, plays, or reach. - 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.