Reading data

Creators

Creators are the people producing content for your campaigns. The endpoints under this section give you per-creator performance metrics, cost-per-video, CPM, and their connected social accounts. Useful for spotting your highest-leverage creators or for paying out partnership bonuses.

GET/campaigns/{campaignId}/creators

List creators in a campaign

Each creator comes with their videos, views, payouts, CPM, and cost-per-video. Sort by cpm or cost_per_video to find the under-performers, or by total_views for top performers.

pageinteger

Page number

per_pageinteger

Items per page

searchstring

Search by creator name

statusenum

active or blocked

sortstring

total_views, total_likes, total_payout, cpm, cost_per_video

const response = await fetch(
  "https://ugcbloom.com/api/v1/campaigns/:campaignId/creators", {
  headers: {
    "Authorization": "Bearer ugcb_live_your_api_key_here"
  }
}
);

const data = await response.json();

GET/campaigns/{campaignId}/creators/{creatorId}

Get a single creator

Drill-in with all of the creator's video submissions, per-platform stats, and their connected accounts.

const response = await fetch(
  "https://ugcbloom.com/api/v1/campaigns/:campaignId/creators/:creatorId", {
  headers: {
    "Authorization": "Bearer ugcb_live_your_api_key_here"
  }
}
);

const data = await response.json();