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.

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.

Response time trends

Chart daily response times in Tableau to identify which days your team responds fastest and where bottlenecks occur

Volume forecasting

Track message volumes over weeks to predict busy periods and adjust team scheduling

Performance improvement

Visualize response rate improvements after implementing new workflows or training

​
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 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.
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:

​
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. 
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
Date format matters: Always use YYYY-MM-DD format for dates (e.g., 2025-05-01). Other formats will cause errors.

​
Sample response

The response returns time-series data organized by date. Each metric has daily values for your reporting period. 
{
    "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"
}
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.
Want aggregated totals instead? Use the Community Metric report to get summed KPIs without time breakdowns.

​
Next steps