TimeseriesDataPointDto

  • endDate
    Type: string
    required

    End of the time bucket (inclusive)

  • metrics
    Type: object · TimeseriesMetricsDto
    required
    • clicks
      Type: number | null

      Total number of clicks on the content.

    • comments
      Type: number | null

      Total number of comments on the content. For Twitch streams, this represents chat messages.

    • cpe
      Type: number | null

      Cost per engagement, calculated as the ratio of cost to total engagements. Exists in organic, paid, and blended (total) variants. A lower CPE indicates more cost-efficient content.

    • cpm
      Type: number | null

      Cost per thousand impressions, calculated as (cost / impressions) × 1,000. Exists in organic, paid, and blended (total) variants. A lower CPM indicates more cost-efficient content in terms of reach/visibility.

    • engagementRate
      Type: number | null

      Percentage of impressions that resulted in an engagement action. Calculated as (engagements / impressions) × 100. Exists in organic, paid, and blended (total) variants.

    • engagements
      Type: number | null

      Total number of engagement actions on the content. Calculated as the sum of likes, comments, shares, clicks, and saves (where applicable). The paid engagement formula differs slightly by content type (e.g., TikTok excludes saves from paid engagements).

    • estimatedValueGenerated
      Type: number | null

      Estimated monetary value of organic engagement, calculated using industry benchmark rates. Calculated as the sum of value of likes, value of comments, value of impressions, and value of shares, using platform-specific benchmark multipliers. Also referred to as "estimated value generated" in some API responses.

    • impressions
      Type: number | null

      Total number of times the content was displayed. The source of this metric varies by content type: for video content types like reels, it may represent video plays; for story and streaming content, it may represent views.

    • likes
      Type: number | null

      Total number of likes received on the content.

    • paidComments
      Type: number | null

      Paid variant. Total number of comments on the content. For Twitch streams, this represents chat messages.

    • paidEngagementRate
      Type: number | null

      Paid variant. Percentage of impressions that resulted in an engagement action. Calculated as (engagements / impressions) × 100. Exists in organic, paid, and blended (total) variants.

    • paidEngagements
      Type: number | null

      Paid variant. Total number of engagement actions on the content. Calculated as the sum of likes, comments, shares, clicks, and saves (where applicable). The paid engagement formula differs slightly by content type (e.g., TikTok excludes saves from paid engagements).

    • paidImpressions
      Type: number | null

      Paid variant. Total number of times the content was displayed. The source of this metric varies by content type: for video content types like reels, it may represent video plays; for story and streaming content, it may represent views.

    • paidLikes
      Type: number | null

      Paid variant. Total number of likes received on the content.

    • paidReach
      Type: number | null

      Paid variant. Number of unique accounts that saw the content.

    • paidShares
      Type: number | null

      Paid variant. Total number of shares of the content. For Pinterest, this represents pin saves. For Twitter/X, this represents retweets.

    • paidViews
      Type: number | null

      Paid variant. Number of times the content was viewed. For Instagram content, this is the new "views" metric from the Instagram Graph API (replacing deprecated "impressions"). For TikTok, views represent organic video views.

    • postsCount
      Type: number | null

      Total number of content pieces (posts) in the reporting scope. Exists in organic and paid variants.

    • reach
      Type: number | null

      Number of unique accounts that saw the content.

    • shares
      Type: number | null

      Total number of shares of the content. For Pinterest, this represents pin saves. For Twitter/X, this represents retweets.

    • views
      Type: number | null

      Number of times the content was viewed. For Instagram content, this is the new "views" metric from the Instagram Graph API (replacing deprecated "impressions"). For TikTok, views represent organic video views.

  • startDate
    Type: string
    required

    Start of the time bucket (inclusive)