Actions33
- Account Data Actions
- General Data Actions
- Integration Actions
- Project Actions
- Tracked Account Actions
- Tracked Individual Video Actions
- Video Data Actions
General Data → Get Interaction Metrics
AI-generatedSummary
Retrieves daily interaction metrics (views, likes, comments, shares, bookmarks) for videos within a specified date range and optional filters.
Inputs
- dateRangeFrom (required) — Start date for the date range (YYYY-MM-DD). Defaults to 14 days ago.
- dateRangeTo (required) — End date for the date range (YYYY-MM-DD). Defaults to today.
- filters — Optional collection of filters including accounts, content types, limit, metric, onlyPublished, platforms, and projects.
- options — Optional collection of options including simplifyOutput.
Output shape
A list of items, each containing daily metrics with keys: date, views, likes, comments, shares, bookmarks.
When 'Simplify Output' is enabled, the raw response is transformed into a list of daily metrics. Otherwise, the raw API response is returned.
Examples
Example 1: Get daily engagement metrics for the last 7 days for all videos.
Date Range: From 7 days ago to today; Filters: Empty
Example 2: Get daily views and likes for videos on TikTok within a specific project.
Date Range: Custom; Filters: Platforms: TikTok, Projects: Selected
Example 3: Get simplified daily metrics with a limit on the number of results.
Date Range: Custom; Filters: Limit: 10; Options: Simplify Output: true