Bloss Docs

Your stats across all brands

Developers
GET
/creator/stats

The numbers on your creator Dashboard: all-time views, likes, comments, followers and videos across every brand, per-platform audience, per-day series for the range, a per-brand breakdown and your top videos. Days are UTC. Earnings are not included; read them 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

Query Parameters

from?string

First day, YYYY-MM-DD. Default: 30 days before to.

to?string

Last day, YYYY-MM-DD. Default: today.

Response Body

Success.

application/json
  1. response
range*

The day range used, inclusive.

totals*

All-time totals across every brand (the dashboard's KPI strip).

videoCounts*
audience*
daily*array<>

Views, likes and comments gained per day in the range.

cumulative*array<>

Running totals per day in the range.

followerGrowth*array<>
brands*array<>

Per-brand breakdown (lifetime numbers).

topVideos*
curl -X GET 'https://example.com/api/v1/creator/stats'
{  "range": {    "from": "string",    "to": "string"  },  "totals": {    "followers": 0,    "views": 0,    "likes": 0,    "comments": 0,    "videoCount": 0,    "brandCount": 0  },  "videoCounts": {    "total": 0,    "byPlatform": {      "instagram": 0,      "tiktok": 0,      "youtube": 0,      "facebook": 0    }  },  "audience": {    "totalFollowers": 0,    "engagementRate": 0,    "platforms": [      {        "platform": "string",        "handle": "string",        "followers": 0,        "engagementRate": 0      }    ]  },  "daily": [    {      "date": "string",      "views": 0,      "likes": 0,      "comments": 0    }  ],  "cumulative": [    {      "date": "string",      "views": 0,      "likes": 0,      "comments": 0    }  ],  "followerGrowth": [    {      "date": "string",      "followers": 0    }  ],  "brands": [    {      "kind": "primary",      "id": "string",      "name": "string",      "brandSlug": "string",      "status": "string",      "joinedAt": "string",      "platforms": [        {          "platform": "instagram",          "handle": "string",          "followers": 0        }      ],      "followers": 0,      "views": 0,      "likes": 0,      "comments": 0,      "videoCount": 0    }  ],  "topVideos": {    "byViews": [      {        "id": "string",        "platform": "string",        "url": "string",        "title": "string",        "views": 0,        "likes": 0,        "comments": 0,        "engagementRate": 0,        "postedAt": "string"      }    ],    "byEngagement": [      {        "id": "string",        "platform": "string",        "url": "string",        "title": "string",        "views": 0,        "likes": 0,        "comments": 0,        "engagementRate": 0,        "postedAt": "string"      }    ]  }}

Was this page helpful?

Your marketplace profile GET

Your Bloss marketplace creator profile as you see it on Marketplace profile: bio, niches, rate, listing status, socials with followers, personal brands, badges and review summary. 404 until you've finished setting up a marketplace profile.

Campaign API keys

Create, use and revoke brand keys for the Campaign API (v0).