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

# Track community metrics over time with graph report

> Visualize community team performance trends over time using time-series data.

Track how your Community metrics change day by day across Instagram, TikTok, Facebook, YouTube, and X. This guide shows you how to pull time-series data using the Graph report. You'll get daily breakdowns ready to visualize trends and measure team performance over time.

***

## Use cases

Measuring Community team performance at a single point in time doesn't show you the full picture. Graph reports give you daily metrics so you can spot patterns, track improvement, and measure the impact of process changes.

<CardGroup cols={3}>
  <Card title="Response time trends">
    Chart daily response times in Tableau to identify which days your team responds fastest and where bottlenecks occur
  </Card>

  <Card title="Volume forecasting">
    Track message volumes over weeks to predict busy periods and adjust team scheduling
  </Card>

  <Card title="Performance improvement">
    Visualize response rate improvements after implementing new workflows or training
  </Card>
</CardGroup>

***

## 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](/guides/get-started/quickstart) for more details.

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

***

**Supported platforms**

This report supports these channels:

* Instagram
* TikTok
* Facebook
* YouTube
* X

**About graph reports**

Graph reports return daily values organized by date. Use graph reports when you want to chart trends or visualize changes over time.

***

## 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`
        * TikTok: `TIKTOK`
        * Facebook: `FACEBOOK`
        * YouTube: `YOUTUBE`
        * X: `TWITTER`

        Request multiple channels by separating with commas (e.g., `INSTAGRAM,TIKTOK,FACEBOOK`)
      </td>
    </tr>

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

      <td>
        Community metrics to track over time:

        * Messages Received: `MESSAGES_RECEIVED` - Total messages received
        * Reply Rate: `REPLY_RATE` - Percentage of messages replied to by your team
        * Response Time: `RESPONSE_TIME` - Average time to respond to messages

        Request multiple metrics by separating with commas (e.g., `MESSAGES_RECEIVED,REPLY_RATE,RESPONSE_TIME`)
      </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. Use same dates if no comparison needed
      </td>
    </tr>

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

      <td>
        Set to `GRAPH` for time-series data
      </td>
    </tr>
  </tbody>
</Table>

***

### Step 2: Make the API call

Send a GET request using the parameters from Step 1. This example gets daily messages received for brand `144` on Instagram from May 1-7, with April 1-7 as the comparison period.

```http theme={null}
GET https://dashboard.dashsocial.com/reports/data
  ?channels=INSTAGRAM
  &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=MESSAGES_RECEIVED
  &report_type=GRAPH
```

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

#### Sample response

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

```json theme={null}
{
    "data": {
        "144": {
            "avatar": "https://cdn.dashsocial.com/avatars/2306810931.jpeg",
            "data_type": "BRAND",
            "metrics": {
                "MESSAGES_RECEIVED": {
                    "ALL_CHANNELS": {
                        "2025-05-02T00:00:00.000Z": 2
                    }
                }
            },
            "name": "sunny.today",
            "user_has_access": true
        },
        "metrics": {
            "MESSAGES_RECEIVED": {
                "ALL_CHANNELS": {
                    "2025-05-02T00:00:00.000Z": 2
                }
            }
        }
    },
    "product_category": "COMMUNITY"
}
```

<Info>
  **Understanding the response:** Metrics are organized by brand ID and grouped by channel. In this example:

  * Brand `144` ("sunny.today") received 2 messages on May 2, 2025
  * The date is in ISO 8601 format with timezone (`2025-05-02T00:00:00.000Z`)
  * `ALL_CHANNELS` aggregates data if you requested multiple platforms

  Use this time-series data in BI tools like Power BI, Tableau, or Looker to create trend charts and spot patterns in your Community performance.
</Info>

<Tip>
  **Want aggregated totals instead?** Use the [Community Metric report](/guides/community-metric-report) to get summed KPIs without time breakdowns.
</Tip>

***

## Next steps

* [Get Aggregated Community Totals with Metric Report →](/guides/track-team-performance-with-metric-report)
* [Track Individual Conversation Performance with Content Report →](/guides/community-content-report)
* [Compare Community Performance Across Brands →](/guides/multi-brand-community-report)
* [View the Full API Reference →](https://developers.dashsocial.com/reference/get_reports-data)