Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.dashsocial.com/llms.txt

Use this file to discover all available pages before exploring further.

Measure your brand’s total social impact combining owned and earned content. This guide shows you how to pull Total Social Impact (TSI) metrics using the metric report. TSI unifies your brand’s social presence by aggregating both content you publish and content where others mention your brand.

​
Use cases

Calculating combined social impact manually across owned and earned content is complex. TSI metric reports give you unified totals in seconds.

Executive reporting

Build quarterly reports showing total social impact across all channels for leadership presentations

Campaign ROI analysis

Measure combined impact from paid posts and organic influencer mentions to calculate true campaign ROI

Cross-channel benchmarking

Compare total social impact across Instagram, TikTok, and Facebook to identify your most valuable channels

Year-over-year growth

Track how your unified social presence grows over time by comparing TSI scores across quarters

​
Before you start

Make sure you have:
  • API Key - Your authentication token from Dash Social developer settings
  • Brand ID - The ID for each brand you want to report on
Check out our API Quickstart if you need help getting these.
Test in the UI first: Create a Dashboard in the Dash Social UI and configure your TSI report there. This previews the metrics and validates your filters before writing 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 metric reports 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 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=TOTAL_METRIC
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 TSI totals for each channel, organized by brand. The value field shows TSI for your reporting period. The context field shows the comparison period total. The context_change field shows the percentage change. 
{
    "data": {
        "144": {
            "avatar": "https://cdn.dashsocial.com/avatars/2306810931.jpeg",
            "data_type": "BRAND",
            "metrics": {
                "TOTAL_TSI": {
                    "FACEBOOK": {
                        "context": 24146,
                        "context_change": 0.026339766420939287,
                        "value": 24782
                    },
                    "INSTAGRAM": {
                        "context": 787708,
                        "context_change": 0.0014332722277798373,
                        "value": 788837
                    },
                    "INSTAGRAM_STORIES": {
                        "context": 1664,
                        "context_change": 0.009615384615384616,
                        "value": 1680
                    },
                    "INSTAGRAM_UGC": {
                        "context": 3037,
                        "context_change": 0.0009878169245966415,
                        "value": 3040
                    },
                    "LINKEDIN": {
                        "context": 1719,
                        "context_change": 0.38801628853984876,
                        "value": 2386
                    },
                    "PINTEREST": {
                        "context": 3272508,
                        "context_change": 0.010491647384819227,
                        "value": 3306842
                    },
                    "TIKTOK": {
                        "context": 109518,
                        "context_change": 0.01897404992786574,
                        "value": 111596
                    },
                    "TIKTOK_UGC": {
                        "context": 13286,
                        "context_change": 0.08821315670630739,
                        "value": 14458
                    },
                    "TWITTER": {
                        "context": 47300,
                        "context_change": 0.0038054968287526427,
                        "value": 47480
                    },
                    "YOUTUBE": {
                        "context": 230,
                        "context_change": 0.0,
                        "value": 230
                    }
                }
            },
            "name": "sunny.today",
            "user_has_access": true
        }
    },
    "product_category": "TSI"
}
Understanding the response: TSI scores are organized by brand ID and broken down by channel. In this example, brand 144 (“sunny.today”) achieved a total Instagram TSI of 788,837 during May 1-7, up 0.14% from 787,708 during April 1-7. The largest growth came from LinkedIn (38.8% increase) and TikTok UGC (8.8% increase). Feed this data into your BI tool or executive dashboard to track unified social impact across owned and earned content.
Calculating total impact: To get overall TSI across all channels, sum the value fields for each channel. In this example, brand 144’s total TSI is 4,304,331 (sum of all channels).

​
Next steps