Bloss Docs

Your videos in a brand

Developers
GET
/creator/brands/{brandId}/videos

Your synced videos in one brand, as on My Videos: platform, link, posted time, views, likes, comments, shares and saves, the set each belongs to, tags, and status flags. Newest first. Pay per set is not included; read it with the earnings endpoints.

Authorization

bearerAuth creator:read
headerAuthorizationBearer <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: creator:read

Path Parameters

brandId*string

A brand id from GET /me or GET /creator/brands.

Length1 <= length

Query Parameters

limit?integer

Page size, 1–100. Default 50.

Range1 <= value <= 100
Default50
cursor?string

The nextCursor from the previous page. Omit for the first page.

Length1 <= length
platform?string

Only this platform: instagram, tiktok, youtube or facebook.

Value in"instagram""tiktok""youtube""facebook"
updatedSince?string

Only videos changed (e.g. new metrics) at or after this time.

Match^(?:(?:\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)))$
Formatdate-time

Response Body

Success.

application/json
  1. 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/creator/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,      "saves": 0,      "setId": "string",      "inSet": true,      "irrelevant": true,      "addedByUrl": true,      "availability": "string",      "tags": [        {          "id": "string",          "name": "string",          "color": "string"        }      ],      "updatedAt": "string"    }  ],  "nextCursor": "string"}

Was this page helpful?

The team's videos behind one day GET

The videos behind one day of the Creators hub team chart: those posted that day, or those that gained that day, with each video's creator. Totals cover every match, not just this page. Only available where the brand shares stats with its creators.

Your views per day in a brand GET

Views, likes, comments and shares your videos in one brand gained each day, as on your brand dashboard's momentum chart. Days are in the brand's time zone.