Bloss Docs

A creator's account analytics

Developers
GET
/brands/{brandId}/creators/{creatorId}/social-analytics

Account-level analytics for each platform the creator connected for cross-posting (followers, views, impressions, likes, comments, posts), and the audience breakdowns a platform reports (Instagram: country, city, gender, age; TikTok: age, city). The latest stored figures, as the profile's Social analytics panel shows them; this never forces a refresh. Empty when the creator connected nothing.

Authorization

bearerAuth creators: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: creators:read

Path Parameters

brandId*string

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

Length1 <= length
creatorId*string

A creator id from GET /brands/{brandId}/creators.

Length1 <= length

Response Body

Success.

application/json
  1. response
analytics*array<>
demographics*array<>
curl -X GET 'https://example.com/api/v1/brands/string/creators/string/social-analytics'
{  "analytics": [    {      "platform": "instagram",      "followers": 0,      "following": 0,      "postCount": 0,      "views": 0,      "viewsUnique": 0,      "impressions": 0,      "impressionsUnique": 0,      "likes": 0,      "comments": 0,      "updatedAt": "string"    }  ],  "demographics": [    {      "platform": "instagram",      "dimensions": [        {          "kind": "string",          "title": "string",          "isPercent": true,          "slices": [            {              "label": "string",              "value": 0,              "share": 0,              "countryCode": "string"            }          ]        }      ]    }  ]}

Was this page helpful?

Your brand's reviews of a creator GET

The reviews this brand left the creator, one per payout cycle, newest first, with whether the creator pinned each to their public profile. Empty when the creator isn't linked to a Bloss creator profile yet (`hasMarketplaceProfile` false), as reviews need one.

A creator's trial GET

Trial progress as admins see it, whatever the creator's status now: the goal (qualifying videos, each reaching `viewGoal` views, within `trialDays` of joining), progress, days left, and the videos posted in the trial window, each marked if it qualifies. When the brand runs no trial everyone passes and `videos` is empty.