Bloss Docs

The team's videos behind one day

Developers
GET
/creator/brands/{brandId}/team-analytics/{date}

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.

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
date*string

The day, YYYY-MM-DD in the brand's time zone.

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
from?string

The chart window's first day; default date. Must include date.

to?string

The chart window's last day; default date. Must include date.

kind?string

"posted" (default): videos posted that day; "gained": videos that gained views or engagement that day.

Default"posted"
Value in"posted""gained"
metric?string

For kind=gained: what counts as gaining. Default "any".

Default"any"
Value in"views""engagement""any"
platform?string

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

Value in"instagram""tiktok""youtube""facebook"
sort?string
Default"views"
Value in"views""likes""eng"

Response Body

Success.

application/json
  1. response
data*array<>
nextCursor*|

Pass as cursor to get the next page; null on the last page.

total*number

Videos matching, across all pages.

totals*
curl -X GET 'https://example.com/api/v1/creator/brands/string/team-analytics/string'
{  "data": [    {      "id": "string",      "platform": "string",      "url": "string",      "caption": "string",      "thumbnailUrl": "string",      "postedAt": "string",      "views": 0,      "likes": 0,      "comments": 0,      "shares": 0,      "creator": {        "id": "string",        "name": "string",        "handle": "string"      }    }  ],  "nextCursor": "string",  "total": 0,  "totals": {    "views": 0,    "likes": 0,    "comments": 0,    "shares": 0  }}

Was this page helpful?

A brand's team views per day GET

The whole team's views, likes, comments and shares per day in a brand, as the Creators hub chart shows them. Only available where the brand shares stats with its creators. Days are in the brand's time zone.

Your videos in a brand GET

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.