The brand's videos
The creators' videos as the Video Vault lists them, newest post first: creator, platform, link, posted time, views, likes, comments and shares, the set (pair) each belongs to, tags, link health and eligibility. Same membership as the Vault: live creators, videos with a posted date and tracked metrics. Metrics are live, or as of the window's last day when to or the cycle ended in the past. Pay is not included.
bearerAuth videos:readAuthorizationBearer <token>Personal access token. Scopes: account:read, creator:read, creator:earnings, managed:read, coach:read, brand:read, creators:read, videos:read, analytics:read, recruitment:read, engagement:read, support:read, integrations:read, payouts:read, funds:read, billing:read.
Scope: videos:read
brandId*stringA brand id from GET /me or GET /creator/brands.
1 <= lengthlimit?integerPage size, 1–100. Default 50.
1 <= value <= 10050cursor?stringThe nextCursor from the previous page. Omit for the first page.
1 <= lengthplatform?stringOnly this platform: instagram, tiktok, youtube or facebook.
"instagram""tiktok""youtube""facebook"creatorId?stringOnly this creator's videos.
tagIds?stringComma-separated tag ids (from GET /brands/{brandId}/tags). Matches any of them.
groupIds?stringComma-separated creator-group ids (from GET /brands/{brandId}/creator-groups); __ungrouped__ selects creators in no group. Matches creators in any of them. An unknown group id is a 400.
cycleId?stringOnly videos posted inside this payout cycle; metrics are then as of the cycle's last day.
from?stringPosted on or after this day, YYYY-MM-DD in the brand's time zone.
to?stringPosted on or before this day, YYYY-MM-DD in the brand's time zone.
q?stringSearch captions, titles, and creator names and handles.
includeIrrelevant?string"true" to include videos marked irrelevant. Default false.
"true""false"eligibleOnly?string"true" for videos whose set meets the payout rules only.
"true""false"linkHealth?string"has_dead": only sets holding a post whose link is dead; "no_dead": only sets with none.
"has_dead""no_dead"updatedSince?stringOnly videos changed (e.g. new metrics) at or after this time.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$date-timeSuccess.
application/json- response
data*array<>nextCursor*|Pass as cursor to get the next page; null on the last page.
curl -X GET 'https://example.com/api/v1/brands/string/videos'{ "data": [ { "id": "string", "platform": "string", "platformVideoId": "string", "url": "string", "title": "string", "caption": "string", "thumbnailUrl": "string", "durationSeconds": 0, "postedAt": "string", "views": 0, "likes": 0, "comments": 0, "shares": 0, "engagementRate": 0, "setId": "string", "inSet": true, "irrelevant": true, "addedByUrl": true, "linkHealth": { "status": "available", "reason": "string", "unavailableAt": "string", "detectedOwnerHandle": "string" }, "tags": [ { "id": "string", "name": "string", "color": "string" } ], "creator": { "id": "string", "name": "string", "handle": "string" }, "eligibility": { "set": "eligible", "video": "eligible", "reason": "string" }, "updatedAt": "string" } ], "nextCursor": "string"}Videos the brand tracks by URL GET
Posts the brand added by URL to follow their metrics (any account, not just its creators), as on the admin Videos page, newest added first. 404 when the brand hasn't turned video tracking on.
Your pending invitations and invite links GET
Email invitations you sent that haven't expired yet, and your share links with how often each was used. The invite tokens and link codes themselves are never returned: copy a link from the app.