Track TSI trends over time with graph report

Track how your Total Social Impact changes day by day across all channels. This guide shows you how to pull TSI time-series data using the Graph report. You’ll get daily breakdowns ready to visualize trends and measure unified social presence over time.

Use cases

Measuring TSI at a single point in time doesn’t show you how your combined owned and earned presence evolves. Graph reports give you daily TSI values so you can spot growth patterns, track campaign momentum, and demonstrate social impact improvements to stakeholders.

Campaign impact tracking

Chart daily TSI during campaign periods to measure how owned posts and earned mentions together drive social presence growth

Quarterly growth reporting

Visualize TSI trends across Q1, Q2, Q3, and Q4 in executive dashboards to show year-over-year social impact improvements

Channel momentum analysis

Track which channels (Instagram, TikTok, etc.) are growing TSI fastest to identify where to invest more resources

Earned vs owned balance

Compare daily TSI from owned content versus UGC mentions to understand which drives more total impact

Before you start

Make sure you have:

API access token with permissions to the relevant brand.
Brand ID for the account you want to query.

See API Quickstart for more details.

Test in the UI first: Create a Dashboard in the Dash Social UI and configure your TSI graph report there. This lets you preview the time-series behavior and validate that your filters return the right data before writing any code.

What TSI measures: Total Social Impact combines impressions from your published content (owned) with impressions from posts where others mention your brand (earned). This gives you a complete view of your social presence beyond just content you create.

Supported platforms This report supports these channels:

Instagram
Instagram Stories
Instagram UGC
TikTok
TikTok UGC
Facebook
Pinterest
YouTube
LinkedIn
X

Understanding channel types: Channels with “UGC” track earned content (mentions). Channels without “UGC” track owned content (your posts). Request both to get complete social impact across owned and earned.

About TSI graph reports Graph reports return daily TSI values organized by date. Use graph reports when you want to chart trends or visualize changes over time. TSI reports support only one metric: Total Social Impact (TOTAL_TSI). This combines impressions from owned and earned content using Dash’s proprietary scoring algorithm.

Implementation

Step 1: Map your parameters

Review the available parameters before making your API call:

Step 2: Make the API call

Send a GET request using the parameters from Step 1. This example gets daily Total Social Impact for brand 144 across all channels from May 1-7, with April 1-7 as the comparison period.

GET https://dashboard.dashsocial.com/reports/data
  ?channels=INSTAGRAM,INSTAGRAM_STORIES,INSTAGRAM_UGC,TIKTOK,TIKTOK_UGC,FACEBOOK,PINTEREST,YOUTUBE,LINKEDIN,TWITTER
  &brand_ids=144
  &start_date=2025-05-01
  &end_date=2025-05-07
  &context_start_date=2025-04-01
  &context_end_date=2025-04-07
  &metrics=TOTAL_TSI
  &report_type=GRAPH

Date format matters: Always use YYYY-MM-DD format for dates (e.g., 2025-05-01). Other formats will cause errors.

Include all channels: For the most accurate TSI score, include all owned and UGC channels in your request. TSI calculations work best when measuring complete social presence.

Sample response

The response returns time-series TSI data organized by date. Each channel has daily values for your reporting period.

{
    "data": {
        "144": {
            "avatar": "https://cdn.dashsocial.com/avatars/2306810931.jpeg",
            "data_type": "BRAND",
            "metrics": {
                "TOTAL_TSI": {
                    "FACEBOOK": {
                        "2025-05-01T00:00:00.000Z": 3498,
                        "2025-05-02T00:00:00.000Z": 3612,
                        "2025-05-03T00:00:00.000Z": 3544,
                        "2025-05-04T00:00:00.000Z": 3729,
                        "2025-05-05T00:00:00.000Z": 3655,
                        "2025-05-06T00:00:00.000Z": 3421,
                        "2025-05-07T00:00:00.000Z": 3323
                    },
                    "INSTAGRAM": {
                        "2025-05-01T00:00:00.000Z": 112683,
                        "2025-05-02T00:00:00.000Z": 115421,
                        "2025-05-03T00:00:00.000Z": 118337,
                        "2025-05-04T00:00:00.000Z": 121086,
                        "2025-05-05T00:00:00.000Z": 119542,
                        "2025-05-06T00:00:00.000Z": 116198,
                        "2025-05-07T00:00:00.000Z": 85570
                    },
                    "INSTAGRAM_STORIES": {
                        "2025-05-01T00:00:00.000Z": 240,
                        "2025-05-02T00:00:00.000Z": 235,
                        "2025-05-03T00:00:00.000Z": 243,
                        "2025-05-04T00:00:00.000Z": 238,
                        "2025-05-05T00:00:00.000Z": 241,
                        "2025-05-06T00:00:00.000Z": 248,
                        "2025-05-07T00:00:00.000Z": 235
                    },
                    "INSTAGRAM_UGC": {
                        "2025-05-01T00:00:00.000Z": 434,
                        "2025-05-02T00:00:00.000Z": 441,
                        "2025-05-03T00:00:00.000Z": 438,
                        "2025-05-04T00:00:00.000Z": 445,
                        "2025-05-05T00:00:00.000Z": 447,
                        "2025-05-06T00:00:00.000Z": 442,
                        "2025-05-07T00:00:00.000Z": 393
                    },
                    "PINTEREST": {
                        "2025-05-01T00:00:00.000Z": 471835,
                        "2025-05-02T00:00:00.000Z": 473691,
                        "2025-05-03T00:00:00.000Z": 472548,
                        "2025-05-04T00:00:00.000Z": 475102,
                        "2025-05-05T00:00:00.000Z": 474236,
                        "2025-05-06T00:00:00.000Z": 471891,
                        "2025-05-07T00:00:00.000Z": 467539
                    },
                    "TIKTOK": {
                        "2025-05-01T00:00:00.000Z": 15942,
                        "2025-05-02T00:00:00.000Z": 16128,
                        "2025-05-03T00:00:00.000Z": 16335,
                        "2025-05-04T00:00:00.000Z": 16542,
                        "2025-05-05T00:00:00.000Z": 16221,
                        "2025-05-06T00:00:00.000Z": 15883,
                        "2025-05-07T00:00:00.000Z": 14545
                    },
                    "TIKTOK_UGC": {
                        "2025-05-01T00:00:00.000Z": 2065,
                        "2025-05-02T00:00:00.000Z": 2083,
                        "2025-05-03T00:00:00.000Z": 2091,
                        "2025-05-04T00:00:00.000Z": 2104,
                        "2025-05-05T00:00:00.000Z": 2098,
                        "2025-05-06T00:00:00.000Z": 2077,
                        "2025-05-07T00:00:00.000Z": 1940
                    },
                    "TWITTER": {
                        "2025-05-01T00:00:00.000Z": 6783,
                        "2025-05-02T00:00:00.000Z": 6791,
                        "2025-05-03T00:00:00.000Z": 6805,
                        "2025-05-04T00:00:00.000Z": 6812,
                        "2025-05-05T00:00:00.000Z": 6798,
                        "2025-05-06T00:00:00.000Z": 6755,
                        "2025-05-07T00:00:00.000Z": 6536
                    },
                    "YOUTUBE": {
                        "2025-05-01T00:00:00.000Z": 33,
                        "2025-05-02T00:00:00.000Z": 33,
                        "2025-05-03T00:00:00.000Z": 33,
                        "2025-05-04T00:00:00.000Z": 33,
                        "2025-05-05T00:00:00.000Z": 33,
                        "2025-05-06T00:00:00.000Z": 33,
                        "2025-05-07T00:00:00.000Z": 33
                    }
                }
            },
            "name": "sunny.today",
            "user_has_access": true
        }
    },
    "product_category": "TSI"
}

Understanding the response: TSI values are organized by brand ID and broken down by channel and date. In this example:

Brand 144 (“sunny.today”) achieved Instagram TSI of 112,683 on May 1, growing to 121,086 by May 4 before declining to 85,570 on May 7
The dates are in ISO 8601 format with timezone (2025-05-01T00:00:00.000Z)
Pinterest consistently drove the highest daily TSI values (around 471k-475k per day)
Instagram showed strong growth mid-week but dropped on the weekend

Use this time-series data in BI tools like Power BI, Tableau, or Looker to create trend charts and spot patterns in your unified social impact.

Calculating total daily TSI: To get overall TSI for a specific date across all channels, sum the values for that date. For example, on May 1, brand 144’s total TSI was 613,854 (sum of all channels on that date).

Want aggregated totals instead? Use the TSI Metric report to get summed KPIs without time breakdowns.

Documentation Index

​Use cases

Campaign impact tracking

Quarterly growth reporting

Channel momentum analysis

Earned vs owned balance

​Before you start

​Implementation

​Step 1: Map your parameters

​Step 2: Make the API call

​Sample response

​Next steps

Use cases

Before you start

Implementation

Step 1: Map your parameters

Step 2: Make the API call

Sample response

Next steps