Skip to main content

​
Endpoint

POST https://api.ugc.inc/stats/dashboard/daily

​
Overview

Get pre-aggregated daily statistics with all 8 metrics combined into a single response. Returns one record per day with total changes across all filtered accounts and posts. This endpoint is optimized for rendering dashboard charts — it returns ~30-90 rows covering the entire date range instead of per-account or per-post granular data. Metrics included:
  • Followers/Following — daily changes from account statistics
  • Views/Likes/Comments/Shares/Saves — daily changes from post statistics
  • Posts — count of posts created per day

​
Request Body

​
startDate
string
required
Start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z).
​
endDate
string
required
End date in ISO 8601 format (e.g., 2024-01-31T23:59:59Z).
​
accountIds
string[]
Array of account IDs to filter by. Omit to include all accounts.
​
tag
string
Filter by account tag
​
org_group
string
Filter by organization group
​
user_group
string
Filter by user group
​
hosts
string[]
Filter by account device type (e.g., physical_iphone, physical_android, emulated_android)
​
postType
string
Filter by post type. One of video or slideshow.
​
audioIds
string[]
Filter by audio IDs. Use none to include posts without audio.

​
Response

​
data
DashboardDailyStat[]
Array of daily aggregated statistics objects
curl -X POST https://api.ugc.inc/stats/dashboard/daily \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2024-01-31T23:59:59Z",
    "hosts": ["physical_iphone"]
  }'

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": [
    {
      "date": "2024-01-01T00:00:00.000Z",
      "followers": 245,
      "following": 12,
      "views": 18500,
      "likes": 1240,
      "comments": 89,
      "shares": 156,
      "posts": 3
    },
    {
      "date": "2024-01-02T00:00:00.000Z",
      "followers": 310,
      "following": 8,
      "views": 22100,
      "likes": 1580,
      "comments": 112,
      "shares": 198,
      "posts": 5
    }
  ]
}