> ## 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.

# Calculate total social impact across channels

> Measure unified social presence using Total Social Impact metrics across owned and earned channels.

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.

<CardGroup cols={3}>
  <Card title="Executive reporting">
    Build quarterly reports showing total social impact across all channels for leadership presentations
  </Card>

  <Card title="Campaign ROI analysis">
    Measure combined impact from paid posts and organic influencer mentions to calculate true campaign ROI
  </Card>

  <Card title="Cross-channel benchmarking">
    Compare total social impact across Instagram, TikTok, and Facebook to identify your most valuable channels
  </Card>

  <Card title="Year-over-year growth">
    Track how your unified social presence grows over time by comparing TSI scores across quarters
  </Card>
</CardGroup>

***

## 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](https://developer.dashsocial.com/guides/get-started/quickstart) if you need help getting these.

<Info>
  **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.
</Info>

<Tip>
  **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.
</Tip>

***

**Supported platforms**

This report supports these channels:

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

<Info>
  **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.
</Info>

**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:

<Table>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `brand_ids`
      </td>

      <td>
        Brand IDs from the UI. Separate multiple brands with commas (e.g., `144,145,146`)
      </td>
    </tr>

    <tr>
      <td>
        `channels`
      </td>

      <td>
        Social platforms to include:

        * Instagram: `INSTAGRAM`
        * Instagram Stories: `INSTAGRAM_STORIES`
        * Instagram UGC: `INSTAGRAM_UGC`
        * TikTok: `TIKTOK`
        * TikTok UGC: `TIKTOK_UGC`
        * Facebook: `FACEBOOK`
        * Pinterest: `PINTEREST`
        * YouTube: `YOUTUBE`
        * LinkedIn: `LINKEDIN`
        * X: `TWITTER`

        Include both owned and UGC channels for complete TSI (e.g., `INSTAGRAM,INSTAGRAM_UGC,TIKTOK,TIKTOK_UGC`)
      </td>
    </tr>

    <tr>
      <td>
        `metrics`
      </td>

      <td>
        Set to `TOTAL_TSI` - measures your unified social presence by combining impressions from owned content (posts you publish) and earned content (brand mentions by others)
      </td>
    </tr>

    <tr>
      <td>
        `start_date` / `end_date`
      </td>

      <td>
        Reporting date range in YYYY-MM-DD format
      </td>
    </tr>

    <tr>
      <td>
        `context_start_date` / `context_end_date`
      </td>

      <td>
        Comparison date range for period-over-period analysis. Optional
      </td>
    </tr>

    <tr>
      <td>
        `report_type`
      </td>

      <td>
        Set to `TOTAL_METRIC` for aggregated totals
      </td>
    </tr>
  </tbody>
</Table>

***

### 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.

```http theme={null}
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
```

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

<Tip>
  **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.
</Tip>

#### 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.

```json theme={null}
{
    "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"
}
```

<Info>
  **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.
</Info>

<Tip>
  **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).
</Tip>

***

## Next steps

* [Visualize TSI Trends Over Time with Graph Report →](/guides/tsi-graph-report)
* [Compare Owned vs Earned Performance →](/guides/owned-vs-earned)
* [Track Individual Post Performance with Content Report →](/guides/content-report)
* [View the Full API Reference →](https://developers.dashsocial.com/reference/get_reports-data)