Documentation menu

YouTube video insights

Watch metrics for specific YouTube videos.

GEThttps://app.tryadeli.com/api/v1/analytics/youtube/video-insights

AuthorizationBearer <API key>How keys work

Request

curl --fail-with-body "https://app.tryadeli.com/api/v1/analytics/youtube/video-insights?accountId=00000000-0000-4000-8000-000000000003&videoIds=dQw4w9WgXcQ" \
  -H "Authorization: Bearer $ADELI_API_KEY"

Response

{
  "platform": "youtube",
  "accountId": "00000000-0000-4000-8000-000000000003",
  "profileId": "00000000-0000-4000-8000-000000000001",
  "insights": {
    "startDate": "2026-09-05",
    "endDate": "2026-10-02",
    "videos": [
      { "videoId": "dQw4w9WgXcQ", "views": 400, "minutesWatched": 800, "averageViewDurationSeconds": 65, "averageViewPercentage": 54.2, "likes": 15, "comments": 2, "shares": 1, "subscribersGained": 3 }
    ]
  },
  "fetchedAt": "2026-10-05T12:00:00.000Z"
}

Returns watch metrics for specific videos, or for the channel's 20 newest, over the same kind of window as channel insights. Needs yt-analytics.readonly, like channel insights.

Query parameters

accountIduuidRequired: A connected YouTube channel.
profileIduuid: Optional, because accountId names its profile. If you pass both, they must agree.
videoIdsstring: Comma-separated YouTube video ids (providerId from GET /api/v1/posts), at most 50. Omit for the 20 newest.
startDateYYYY-MM-DD: Give both dates or neither; the default is the 28 days ending three days ago.
endDateYYYY-MM-DD

A video YouTube has no figures for in the window comes back with every metric null.

Errors — 401 unauthorized, 400 invalid_request, 404 account_not_found, 404 profile_not_found, 422 connection_expired, 422 provider_not_configured, 429 rate_limited, 502 provider_error.