Get YouTube analytics summary
Returns non-monetary YouTube Analytics channel totals for one connected YouTube account. Defaults to the last 28 complete UTC days when no date range is provided.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Params
account_idstring
Connected YouTube account ID.
Query Params
fromOptionalYYYY-MM-DD
Start date. Aliases: start_date, startDate. Defaults to the first day of the last 28 complete days.
toOptionalYYYY-MM-DD
End date. Aliases: end_date, endDate. Defaults to yesterday in UTC.
Response Body
200
social_account_idstring
UniPost account ID.
platformyoutube
Always youtube.
start_datestring
Applied report start date.
end_datestring
Applied report end date.
metricsobject
Non-monetary YouTube Analytics metrics for the range.
metrics.viewsnumber
Views in the report range.
metrics.likesnumber
Likes in the report range.
metrics.commentsnumber
Comments in the report range.
metrics.sharesnumber
Shares in the report range.
metrics.estimated_minutes_watchednumber
Estimated watch time in minutes.
metrics.average_view_durationnumber
Average view duration in seconds.
metrics.average_view_percentagenumber
Average percentage watched.
metrics.subscribers_gainednumber
Subscribers gained in the report range.
metrics.subscribers_lostnumber
Subscribers lost in the report range.
required_scopes[]string[]
Required provider scopes, including yt-analytics.readonly.
fetched_atstring
UTC fetch timestamp.
401
error.codestring
UNAUTHORIZED, NOT_FOUND, WRONG_PLATFORM, ACCOUNT_DISCONNECTED, NEEDS_RECONNECT, VALIDATION_ERROR, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for support.
404
error.codestring
UNAUTHORIZED, NOT_FOUND, WRONG_PLATFORM, ACCOUNT_DISCONNECTED, NEEDS_RECONNECT, VALIDATION_ERROR, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for support.
409
error.codestring
UNAUTHORIZED, NOT_FOUND, WRONG_PLATFORM, ACCOUNT_DISCONNECTED, NEEDS_RECONNECT, VALIDATION_ERROR, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for support.
422
error.codestring
UNAUTHORIZED, NOT_FOUND, WRONG_PLATFORM, ACCOUNT_DISCONNECTED, NEEDS_RECONNECT, VALIDATION_ERROR, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for support.
502
error.codestring
UNAUTHORIZED, NOT_FOUND, WRONG_PLATFORM, ACCOUNT_DISCONNECTED, NEEDS_RECONNECT, VALIDATION_ERROR, or UPSTREAM_ERROR.
error.normalized_codestring
Lowercase error code.
error.messagestring
Human-readable error message.
request_idstring
Request identifier for support.