TagMango DocsCourse
Get Course Reporting Summary
Returns creator-level course analytics across all courses (or a filtered subset).
Includes per-course metrics, top 10 most-watched courses, top 10 best-rated courses, watch time by category, and ratings by category.
Authorization
bearer AuthorizationBearer <token>
In: header
Query Parameters
startDate?string
Start date for filtering data
Format
date-timeendDate?string
End date for filtering data
Format
date-timecourse?array<>
Comma-separated course IDs to filter
Header Parameters
x-whitelabel-host*string
Host name of the dashboard, ex: mydomain.tagmango.com
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/courses/reporting/summary" \ -H "x-whitelabel-host: string"{
"courses": [
{
"courseId": "string",
"title": "string",
"categoryName": "string",
"initiated": 0,
"completed": 0,
"averageProgressPercent": 0,
"watchTimeTotalSeconds": 0,
"catalogTotalClicks": 0,
"averageRating": 0,
"reviewCount": 0
}
],
"mostWatchedCourses": [
{
"courseId": "string",
"title": "string",
"categoryName": "string",
"initiated": 0,
"completed": 0,
"averageProgressPercent": 0,
"watchTimeTotalSeconds": 0,
"catalogTotalClicks": 0,
"averageRating": 0,
"reviewCount": 0
}
],
"bestRatedCourses": [
{
"courseId": "string",
"title": "string",
"categoryName": "string",
"initiated": 0,
"completed": 0,
"averageProgressPercent": 0,
"watchTimeTotalSeconds": 0,
"catalogTotalClicks": 0,
"averageRating": 0,
"reviewCount": 0
}
],
"watchTimeByCategory": [
{
"categoryName": "string",
"totalWatchTimeSeconds": 0
}
],
"ratingsByCategory": [
{
"categoryName": "string",
"averageRating": 0,
"reviewCount": 0
}
]
}{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "WORKSHOP_MANGO_FORBIDDEN",
"message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}